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

Vedi anche

LSA_UNICODE_STRING

LsaAddAccountRights

LsaFreeMemory

LsaRemoveAccountRights