GetAclInformation, fonction (securitybaseapi.h)

Article
08/25/2023

La fonction GetAclInformation récupère des informations sur une liste de contrôle d’accès (ACL).

Syntaxe

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

Paramètres

[in] pAcl

Pointeur vers une liste de contrôle d’accès. La fonction récupère des informations sur cette liste de contrôle d’accès. Si une valeur null est transmise, la fonction provoque une violation d’accès.

[out] pAclInformation

Pointeur vers une mémoire tampon pour recevoir les informations demandées. La structure placée dans la mémoire tampon dépend de la classe d’informations demandée dans le paramètre dwAclInformationClass .

[in] nAclInformationLength

Taille, en octets, de la mémoire tampon pointée vers le paramètre pAclInformation .

[in] dwAclInformationClass

Valeur de l’énumération ACL_INFORMATION_CLASS qui indique la classe d’informations demandée. Ce paramètre peut être l’une des deux valeurs de cette énumération :

Si la valeur est AclRevisionInformation, la fonction remplit la mémoire tampon pointée par le paramètre pAclInformation avec une structure ACL_REVISION_INFORMATION .
Si la valeur est AclSizeInformation, la fonction remplit la mémoire tampon pointée par le paramètre pAclInformation avec une structure ACL_SIZE_INFORMATION .

Valeur retournée

Si la fonction réussit, la fonction retourne une valeur différente de zéro.

Si la fonction échoue, elle retourne zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	securitybaseapi.h (inclure Windows.h)
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll