Funzione SetSecurityDescriptorSacl (securitybaseapi.h)
La funzione SetSecurityDescriptorSacl imposta informazioni in un elenco di controllo di accesso del sistema (SACL). Se nel descrittore di sicurezza è già presente un SACL, viene sostituito.
Sintassi
BOOL SetSecurityDescriptorSacl(
[in, out] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[in] BOOL bSaclPresent,
[in, optional] PACL pSacl,
[in] BOOL bSaclDefaulted
);
Parametri
[in, out] pSecurityDescriptor
Puntatore alla struttura SECURITY_DESCRIPTOR a cui la funzione aggiunge SACL. Questo descrittore di sicurezza deve essere in formato assoluto, il che significa che i membri devono essere puntatori ad altre strutture, anziché offset ai dati contigui.
[in] bSaclPresent
Indica la presenza di un SACL nel descrittore di sicurezza. Se questo parametro è TRUE, la funzione imposta il flag di SE_SACL_PRESENT nella struttura SECURITY_DESCRIPTOR_CONTROL e usa i valori nei parametri pSacl e bSaclDefaulted. Se è FALSE, la funzione non imposta il flag di SE_SACL_PRESENT e pSacl e bSaclDefaulted vengono ignorati.
[in, optional] pSacl
Puntatore a una struttura ACL che specifica SACL per il descrittore di sicurezza. Se questo parametro è NULL, un SACL NULL viene assegnato al descrittore di sicurezza. SacL viene fatto riferimento a, non copiato, descrittore di sicurezza.
[in] bSaclDefaulted
Indica l'origine dell'oggetto SACL. Se questo flag è TRUE, SACL è stato recuperato da un meccanismo predefinito. Se è FALSE, SACL è stato specificato in modo esplicito da un utente. La funzione archivia questo valore nel flag SE_SACL_DEFAULTED della struttura SECURITY_DESCRIPTOR_CONTROL . Se questo parametro non è specificato, il flag di SE_SACL_DEFAULTED viene cancellato.
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero.
Se la funzione ha esito negativo, restituisce zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows XP [app desktop | App UWP] |
Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
Piattaforma di destinazione | Windows |
Intestazione | securitybaseapi.h (include Windows.h) |
Libreria | Advapi32.lib |
DLL | Advapi32.dll |
Vedi anche
Controllo di accesso di basso livello