Partager via


GetAclInformation, fonction (securitybaseapi.h)

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

Voir aussi

ACL_INFORMATION_CLASS

ACL_REVISION_INFORMATION

ACL_SIZE_INFORMATION

GetAce

InitializeAcl

IsValidAcl

Access Control de bas niveau

Fonctions Access Control de bas niveau

SetAclInformation