LookupPrivilegeNameA-Funktion (winbase.h)

Die LookupPrivilegeName-Funktion ruft den Namen ab, der den Berechtigungen entspricht, die auf einem bestimmten 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 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] lpLuid

Ein Zeiger auf die LUID, mit der die Berechtigung auf dem Zielsystem bekannt ist.

[out, optional] lpName

Ein Zeiger auf einen Puffer, der eine null-beendete Zeichenfolge empfängt, die den Berechtigungsnamen darstellt. Diese Zeichenfolge könnte beispielsweise "SeSecurityPrivilege" sein.

[in, out] cchName

Ein Zeiger auf eine Variable, der die Größe des lpName-Puffers in einem TCHAR-Wert angibt. Wenn die Funktion zurückgibt, enthält dieser Parameter die Länge des Berechtigungsnamens, ohne das beendende NULL-Zeichen. Wenn der Puffer, auf den der parameter lpName 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, gibt sie null zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

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

Hinweis

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

LookupPrivilegeValue