Funzione LsaAddAccountRights (ntsecapi.h)

La funzione LsaAddAccountRights assegna uno o più privilegi a un account. Se l'account non esiste, LsaAddAccountRights lo crea.

Sintassi

NTSTATUS LsaAddAccountRights(
  [in] LSA_HANDLE          PolicyHandle,
  [in] PSID                AccountSid,
  [in] PLSA_UNICODE_STRING UserRights,
  [in] ULONG               CountOfRights
);

Parametri

[in] PolicyHandle

Handle per un oggetto Policy . L'handle deve avere il diritto di accesso POLICY_LOOKUP_NAMES. Se l'account identificato dal parametro AccountSid non esiste, l'handle deve disporre del diritto di accesso POLICY_CREATE_ACCOUNT. Per altre informazioni, vedere Apertura di un handle oggetto Criteri.

[in] AccountSid

Puntatore al SID dell'account a cui la funzione assegna privilegi.

[in] UserRights

Puntatore a una matrice di strutture LSA_UNICODE_STRING . Ogni struttura contiene il nome di un privilegio da aggiungere all'account. Per un elenco di nomi di privilegi, vedere Costanti dei privilegi.

[in] CountOfRights

Specifica il numero di elementi nella matrice UserRights .

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene STATUS_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice NTSTATUS, che può essere il valore seguente o uno dei valori restituiti della funzione criteri LSA.

È possibile utilizzare la funzione LsaNtStatusToWinError per convertire il codice NTSTATUS in un codice di errore di Windows.

Commenti

Se si specificano privilegi già concessi all'account, vengono ignorati.

Per un esempio che illustra la chiamata a questa funzione, vedere Gestione delle autorizzazioni dell'account.

Requisiti

Vedi anche

LSA_UNICODE_STRING

LsaEnumerateAccountRights

LsaRemoveAccountRights