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

ACL

GetSecurityDescriptorSacl

InitializeSecurityDescriptor

IsValidSecurityDescriptor

Controllo di accesso di basso livello

Funzioni di Controllo di accesso di basso livello

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorOwner