Funzione SetSecurityDescriptorSacl (securitybaseapi.h)

Articolo
03/05/2024

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