LookupPrivilegeNameA-Funktion (winbase.h)
Die LookupPrivilegeName Funktion ruft den Namen ab, der den Berechtigungen entspricht, die für ein bestimmtes System durch einen angegebenen lokal eindeutigen Bezeichner (LUID) dargestellt werden.
Syntax
BOOL LookupPrivilegeNameA(
[in, optional] LPCSTR lpSystemName,
[in] PLUID lpLuid,
[out, optional] LPSTR lpName,
[in, out] LPDWORD cchName
);
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] lpLuid
Ein Zeiger auf die LUID, mit der die Berechtigung im Zielsystem bekannt ist.
[out, optional] lpName
Ein Zeiger auf einen Puffer, der eine mit Null beendete Zeichenfolge empfängt, die den Berechtigungsnamen darstellt. Diese Zeichenfolge könnte z. B. "SeSecurityPrivilege" sein.
[in, out] cchName
Ein Zeiger auf eine Variable, die die Größe in einem TCHAR--Wert des lpName- Puffers angibt. Wenn die Funktion zurückgegeben wird, enthält dieser Parameter die Länge des Berechtigungsnamens, nicht einschließlich des endenden Nullzeichens. Wenn der puffer, auf den der lpName Parameter verweist, zu klein ist, enthält diese Variable die erforderliche Größe.
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 LookupPrivilegeName--Funktion unterstützt nur die im Abschnitt "Definierten Berechtigungen" von Winnt.h angegebenen Berechtigungen. Eine Liste der Werte finden Sie unter Berechtigungskonstanten.
Anmerkung
Der winbase.h-Header definiert LookupPrivilegeName als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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 |