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.
| Codice restituito | Descrizione |
|---|---|
|
Uno dei nomi dei privilegi non è valido. |
È 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
| 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 |