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 mit Null beendete Zeichenfolge, die den Namen des Systems angibt, für das der Berechtigungsname abgerufen wird. Wenn eine NULL-Zeichenfolge angegeben wird, versucht die Funktion, den Berechtigungsnamen im lokalen System zu finden.
[in] lpName
Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen der Berechtigung angibt, wie in der Winnt.h-Headerdatei definiert. Beispielsweise könnte dieser Parameter die Konstante, SE_SECURITY_NAME oder die entsprechende Zeichenfolge "SeSecurityPrivilege" angeben.
[out] lpLuid
Ein Zeiger auf eine Variable, die die LUID empfängt, mit der die Berechtigung auf dem system bekannt ist, das durch den parameter lpSystemName angegeben ist.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt die Funktion "nonzero" zurück.
Wenn die Funktion fehlschlägt, wird null zurückgegeben. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Die LookupPrivilegeValue-Funktion unterstützt nur die im Abschnitt "Definierten Berechtigungen" von Winnt.h angegebenen Berechtigungen. Eine Liste der Werte finden Sie unter Berechtigungskonstanten.
Beispiele
Ein Beispiel, das diese Funktion verwendet, finden Sie unter Aktivieren und Deaktivieren von Berechtigungen.
Anmerkung
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 Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Windows XP [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform- | Fenster |
| Header- | winbase.h (enthalten Windows.h) |
| Library | Advapi32.lib |
| DLL- | Advapi32.dll |