Funzione LsaEnumerateAccountRights (ntsecapi.h)
La funzione LsaEnumerateAccountRights enumera i privilegi assegnati a un account.
Sintassi
NTSTATUS LsaEnumerateAccountRights(
[in] LSA_HANDLE PolicyHandle,
[in] PSID AccountSid,
[out] PLSA_UNICODE_STRING *UserRights,
[out] PULONG CountOfRights
);
Parametri
[in] PolicyHandle
Handle per un oggetto Policy . L'handle deve avere il diritto di accesso POLICY_LOOKUP_NAMES. Per altre informazioni, vedere Apertura di un handle oggetto Criteri.
[in] AccountSid
Puntatore al SID dell'account per cui enumerare i privilegi.
[out] UserRights
Riceve un puntatore a una matrice di strutture LSA_UNICODE_STRING . Ogni struttura contiene il nome di un privilegio mantenuto dall'account. Per un elenco di nomi di privilegi, vedere Costanti dei privilegi
Quando le informazioni non sono più necessarie, passare il puntatore restituito a LsaFreeMemory.
[out] CountOfRights
Puntatore a una variabile che riceve il numero di privilegi nella matrice UserRights .
Valore restituito
Se viene trovato almeno un diritto di account, la funzione ha esito positivo e restituisce STATUS_SUCCESS.
Se non viene trovato alcun diritto di account o se la funzione ha esito negativo per qualsiasi altro motivo, la funzione restituisce un codice NTSTATUS, ad esempio FILE_NOT_FOUND. Per altre informazioni, vedere Valori restituiti della funzione criteri LSA. Usare la funzione LsaNtStatusToWinError per convertire il codice NTSTATUS in un codice di errore di Windows.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ntsecapi.h |
| Libreria | Advapi32.lib |
| DLL | Advapi32.dll |