Fonction LsaEnumerateAccountRights (ntsecapi.h)

  • Article

La fonction LsaEnumerateAccountRights énumère les privilèges attribués à un compte.

Syntaxe

NTSTATUS LsaEnumerateAccountRights(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PSID                AccountSid,
  [out] PLSA_UNICODE_STRING *UserRights,
  [out] PULONG              CountOfRights
);

Paramètres

[in] PolicyHandle

Handle d’un objet Policy . Le handle doit avoir le droit d’accès POLICY_LOOKUP_NAMES. Pour plus d’informations, consultez Ouverture d’un handle d’objet de stratégie.

[in] AccountSid

Pointeur vers le SID du compte pour lequel énumérer les privilèges.

[out] UserRights

Reçoit un pointeur vers un tableau de structures LSA_UNICODE_STRING . Chaque structure contient le nom d’un privilège détenu par le compte. Pour obtenir la liste des noms de privilèges, consultez Constantes de privilèges

Lorsque vous n’avez plus besoin des informations, passez le pointeur retourné à LsaFreeMemory.

[out] CountOfRights

Pointeur vers une variable qui reçoit le nombre de privilèges dans le tableau UserRights .

Valeur retournée

Si au moins un compte droit est trouvé, la fonction réussit et retourne STATUS_SUCCESS.

Si aucun droit de compte n’est trouvé ou si la fonction échoue pour une autre raison, la fonction retourne un code NTSTATUS tel que FILE_NOT_FOUND. Pour plus d’informations, consultez Valeurs de retour de la fonction de stratégie LSA. Utilisez la fonction LsaNtStatusToWinError pour convertir le code NTSTATUS en code d’erreur Windows.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête ntsecapi.h
Bibliothèque Advapi32.lib
DLL Advapi32.dll

Voir aussi

LSA_UNICODE_STRING

LsaAddAccountRights

LsaFreeMemory

LsaRemoveAccountRights