Funzione GetSecurityDescriptorSacl (securitybaseapi.h)

Articolo
03/01/2024

La funzione GetSecurityDescriptorSacl recupera un puntatoreall'elenco di controllo di accesso del sistema (SACL) in un descrittore di sicurezza specificato.

Sintassi

BOOL GetSecurityDescriptorSacl(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] LPBOOL               lpbSaclPresent,
  [out] PACL                 *pSacl,
  [out] LPBOOL               lpbSaclDefaulted
);

Parametri

[in] pSecurityDescriptor

Puntatore alla struttura SECURITY_DESCRIPTOR contenente SACL a cui la funzione recupera un puntatore.

[out] lpbSaclPresent

Puntatore a un flag impostato per indicare la presenza di un SACL nel descrittore di sicurezza specificato. Se questo parametro è TRUE, il descrittore di sicurezza contiene un SACL e i parametri di output rimanenti in questa funzione ricevono valori validi. Se questo parametro è FALSE, il descrittore di sicurezza non contiene un SACL e i parametri di output rimanenti non ricevono valori validi.

[out] pSacl

Puntatore a un puntatore a un elenco di controllo di accesso . Se esiste un SACL, la funzione imposta il puntatore a cui fa riferimento pSacl all'indirizzo del descrittore di sicurezza SACL. Se un SACL non esiste, non viene archiviato alcun valore.

Se la funzione archivia un valore NULL nel puntatore a cui fa riferimento pSacl, il descrittore di sicurezza ha un valore SACL NULL .

[out] lpbSaclDefaulted

Puntatore a un flag impostato sul valore del flag di SE_SACL_DEFAULTED nella struttura SECURITY_DESCRIPTOR_CONTROL se esiste un descrittore di sicurezza.

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