LookupPrivilegeValueA-Funktion (winbase.h)

Die LookupPrivilegeValue-Funktion ruft den lokal eindeutigen Bezeichner (LUID) ab, der auf einem angegebenen System verwendet wird, um den angegebenen Berechtigungsnamen lokal darzustellen.

Syntax

BOOL LookupPrivilegeValueA(
  [in, optional] LPCSTR lpSystemName,
  [in]           LPCSTR lpName,
  [out]          PLUID  lpLuid
);

Parameter

[in, optional] lpSystemName

Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des Systems angibt, auf dem der Berechtigungsname abgerufen wird. Wenn eine NULL-Zeichenfolge angegeben wird, versucht die Funktion, den Berechtigungsnamen auf dem lokalen System zu finden.

[in] lpName

Ein Zeiger auf eine null-beendete Zeichenfolge, die den Namen der Berechtigung angibt, wie in der Winnt.h-Headerdatei definiert. Dieser Parameter könnte beispielsweise die Konstante SE_SECURITY_NAME oder die zugehörige Zeichenfolge "SeSecurityPrivilege" angeben.

[out] lpLuid

Ein Zeiger auf eine Variable, die die LUID empfängt, mit der die Berechtigung auf dem durch den lpSystemName-Parameter angegebenen System bekannt ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion nonzero zurück.

Wenn die Funktion fehlschlägt, gibt sie null zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die LookupPrivilegeValue-Funktion unterstützt nur die Berechtigungen, die im Abschnitt Definierte Berechtigungen von Winnt.h angegeben sind. Eine Liste der Werte finden Sie unter Berechtigungskonstanten.

Beispiele

Ein Beispiel, das diese Funktion verwendet, finden Sie unter Aktivieren und Deaktivieren von Berechtigungen.

Hinweis

Der winbase.h-Header definiert LookupPrivilegeValue als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Weitere Informationen

Zugriffssteuerung

Grundlegende Access Control-Funktionen

LookupPrivilegeDisplayName

LookupPrivilegeName