Funzione GetAclInformation (securitybaseapi.h)

Articolo
03/01/2024

La funzione GetAclInformation recupera informazioni su un elenco di controllo di accesso (ACL).

Sintassi

BOOL GetAclInformation(
  [in]  PACL                  pAcl,
  [out] LPVOID                pAclInformation,
  [in]  DWORD                 nAclInformationLength,
  [in]  ACL_INFORMATION_CLASS dwAclInformationClass
);

Parametri

[in] pAcl

Puntatore a un elenco di controllo di accesso. La funzione recupera informazioni su questo elenco di controllo di accesso. Se viene passato un valore Null, la funzione causa una violazione di accesso.

[out] pAclInformation

Puntatore a un buffer per ricevere le informazioni richieste. La struttura inserita nel buffer dipende dalla classe di informazioni richiesta nel parametro dwAclInformationClass .

[in] nAclInformationLength

Dimensioni, in byte, del buffer a cui punta il parametro pAclInformation .

[in] dwAclInformationClass

Valore dell'enumerazione ACL_INFORMATION_CLASS che indica la classe di informazioni richieste. Questo parametro può essere uno dei due valori di questa enumerazione:

Se il valore è AclRevisionInformation, la funzione riempie il buffer a cui punta il parametro pAclInformation con una struttura ACL_REVISION_INFORMATION .
Se il valore è AclSizeInformation, la funzione riempie il buffer a cui punta il parametro pAclInformation con una struttura ACL_SIZE_INFORMATION .

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