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 |