LsaEnumerateAccountRights-Funktion (ntsecapi.h)

Die LsaEnumerateAccountRights-Funktion listet die Berechtigungen auf, die einem Konto zugewiesen sind.

Syntax

NTSTATUS LsaEnumerateAccountRights(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PSID                AccountSid,
  [out] PLSA_UNICODE_STRING *UserRights,
  [out] PULONG              CountOfRights
);

Parameter

[in] PolicyHandle

Ein Handle für ein Policy-Objekt . Das Handle muss über das POLICY_LOOKUP_NAMES-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Öffnen eines Richtlinienobjekthandles.

[in] AccountSid

Zeiger auf die SID des Kontos, für das Berechtigungen aufgelistet werden sollen.

[out] UserRights

Empfängt einen Zeiger auf ein Array von LSA_UNICODE_STRING Strukturen. Jede Struktur enthält den Namen einer Berechtigung, die vom Konto gehalten wird. Eine Liste der Berechtigungsnamen finden Sie unter Berechtigungskonstanten.

Wenn Sie die Informationen nicht mehr benötigen, übergeben Sie den zurückgegebenen Zeiger an LsaFreeMemory.

[out] CountOfRights

Zeiger auf eine Variable, die die Anzahl der Berechtigungen im UserRights-Array empfängt .

Rückgabewert

Wenn mindestens ein Kontorecht gefunden wird, ist die Funktion erfolgreich und gibt STATUS_SUCCESS zurück.

Wenn keine Kontorechte gefunden werden oder die Funktion aus einem anderen Grund fehlschlägt, gibt die Funktion einen NTSTATUS-Code zurück, z. B. FILE_NOT_FOUND. Weitere Informationen finden Sie unter Rückgabewerte der LSA-Richtlinienfunktion. Verwenden Sie die LsaNtStatusToWinError-Funktion , um den NTSTATUS-Code in einen Windows-Fehlercode zu konvertieren.

Anforderungen

Weitere Informationen

LSA_UNICODE_STRING

LsaAddAccountRights

LsaFreeMemory

LsaRemoveAccountRights