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 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 Anzeigenamen im lokalen System zu finden.
[in] lpName
Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen der Berechtigung angibt, wie in Winnt.h definiert. Beispielsweise könnte dieser Parameter die Konstante, SE_REMOTE_SHUTDOWN_NAME oder die entsprechende Zeichenfolge "SeRemoteShutdownPrivilege" angeben. Eine Liste der Werte finden Sie unter Berechtigungskonstanten.
[out, optional] lpDisplayName
Ein Zeiger auf einen Puffer, der eine mit Null beendete Zeichenfolge empfängt, die den Anzeigenamen der Berechtigungen angibt. Wenn beispielsweise der parameter lpName SE_REMOTE_SHUTDOWN_NAME ist, lautet der Anzeigename des Berechtigungsanzeigenamens "Herunterfahren von einem Remotesystem erzwingen".
[in, out] cchDisplayName
Ein Zeiger auf eine Variable, die die Größe des lpDisplayName- Puffers in TCHAR-s angibt. Wenn die Funktion zurückgegeben wird, enthält dieser Parameter die Länge des Anzeigenamens der Berechtigung, nicht einschließlich des endenden Nullzeichens. 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 fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Die LookupPrivilegeDisplayName--Funktion ruft Anzeigenamen nur für die im Abschnitt "Definierten Berechtigungen" von Winnt.h angegebenen Berechtigungen ab.
Anmerkung
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
| 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 |
Siehe auch
Übersicht über die Zugriffssteuerung