LsaAddAccountRights-Funktion (ntsecapi.h)

Artikel
03/04/2024

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

Freigeben über