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
| 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 |