LookupPrivilegeDisplayNameA-Funktion (winbase.h)

Die LookupPrivilegeDisplayName-Funktion ruft den Anzeigenamen ab, der eine angegebene Berechtigung darstellt.

Syntax

BOOL LookupPrivilegeDisplayNameA(
  [in, optional]  LPCSTR  lpSystemName,
  [in]            LPCSTR  lpName,
  [out, optional] LPSTR   lpDisplayName,
  [in, out]       LPDWORD cchDisplayName,
  [out]           LPDWORD lpLanguageId
);

Parameter

[in, optional] lpSystemName

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

[in] lpName

Ein Zeiger auf eine null-endende Zeichenfolge, die den Namen der Berechtigung angibt, wie in Winnt.h definiert. Mit diesem Parameter kann beispielsweise die Konstante, SE_REMOTE_SHUTDOWN_NAME oder die zugehörige Zeichenfolge "SeRemoteShutdownPrivilege" angegeben werden. Eine Liste der Werte finden Sie unter Berechtigungskonstanten.

[out, optional] lpDisplayName

Ein Zeiger auf einen Puffer, der eine NULL-endende Zeichenfolge empfängt, die den Anzeigenamen der Berechtigung angibt. Wenn der parameter lpName beispielsweise SE_REMOTE_SHUTDOWN_NAME ist, lautet der Anzeigename der Berechtigung "Herunterfahren von einem Remotesystem erzwingen".

[in, out] cchDisplayName

Ein Zeiger auf eine Variable, die die Größe des puffers lpDisplayName in TCHARs angibt. Wenn die Funktion zurückgibt, enthält dieser Parameter die Länge des Anzeigenamens der Berechtigung, ohne das abschließende NULL-Zeichen. Wenn der Puffer, auf den der lpDisplayName-Parameter verweist, zu klein ist, enthält diese Variable die erforderliche Größe.

[out] lpLanguageId

Ein Zeiger auf eine Variable, die den Sprachbezeichner für den zurückgegebenen Anzeigenamen empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die LookupPrivilegeDisplayName-Funktion ruft Anzeigenamen nur für die Berechtigungen ab, die im Abschnitt Definierte Berechtigungen von Winnt.h angegeben sind.

Hinweis

Der winbase.h-Header definiert LookupPrivilegeDisplayName 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

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 (Windows.h einschließen)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Weitere Informationen

Zugriffssteuerung Übersicht

Grundlegende Access Control-Funktionen

LookupPrivilegeName

LookupPrivilegeValue