Fonction LsaEnumerateAccountRights (ntsecapi.h)
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 |