LsaAddAccountRights-Funktion (ntsecapi.h)

  • Artikel

Die LsaAddAccountRights-Funktion weist einem Konto eine oder mehrere Berechtigungen zu. Wenn das Konto nicht vorhanden ist, wird es von LsaAddAccountRights erstellt.

Syntax

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

Parameter

[in] PolicyHandle

Ein Handle für ein Policy-Objekt . Das Handle muss über das zugriffsrecht POLICY_LOOKUP_NAMES verfügen. Wenn das durch den AccountSid-Parameter identifizierte Konto nicht vorhanden ist, muss das Handle über das POLICY_CREATE_ACCOUNT-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Öffnen eines Richtlinienobjekthandles.

[in] AccountSid

Zeiger auf die SID des Kontos, dem die Funktion Berechtigungen zuweist.

[in] UserRights

Zeiger auf ein Array von LSA_UNICODE_STRING Strukturen. Jede Struktur enthält den Namen einer Berechtigung, die dem Konto hinzugefügt werden soll. Eine Liste der Berechtigungsnamen finden Sie unter Berechtigungskonstanten.

[in] CountOfRights

Gibt die Anzahl der Elemente im UserRights-Array an.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert STATUS_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein NTSTATUS-Code, der der folgende Wert oder einer der Rückgabewerte der LSA-Richtlinienfunktion sein kann.

Rückgabecode Beschreibung
STATUS_NO_SUCH_PRIVILEGE
 Einer der Berechtigungsnamen ist ungültig.
 

Sie können die LsaNtStatusToWinError-Funktion verwenden, um den NTSTATUS-Code in einen Windows-Fehlercode zu konvertieren.

Hinweise

Wenn Sie dem Konto bereits erteilte Berechtigungen angeben, werden diese ignoriert.

Ein Beispiel, das den Aufruf dieser Funktion veranschaulicht, finden Sie unter Verwalten von Kontoberechtigungen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ntsecapi.h
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

LSA_UNICODE_STRING

LsaEnumerateAccountRights

LsaRemoveAccountRights