SHQueryInfoKeyA-Funktion (shlwapi.h)
Ruft Informationen zu einem angegebenen Registrierungsschlüssel ab.
Syntax
LSTATUS SHQueryInfoKeyA(
[in] HKEY hkey,
[out, optional] LPDWORD pcSubKeys,
[out, optional] LPDWORD pcchMaxSubKeyLen,
[out, optional] LPDWORD pcValues,
[out, optional] LPDWORD pcchMaxValueNameLen
);
Parameter
[in] hkey
Typ: HKEY
Ein Handle für den derzeit geöffneten Schlüssel oder einen der folgenden vordefinierten Werte.
HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_PERFORMANCE_DATA
HKEY_USERS
[out, optional] pcSubKeys
Typ: LPDWORD
Die Adresse eines DWORD,das die Anzahl von Unterschlüsseln unter dem angegebenen Schlüssel empfängt.
[out, optional] pcchMaxSubKeyLen
Typ: LPDWORD
Die Adresse eines DWORD,das die Anzahl der Zeichen im Namen des Unterschlüssels mit dem größten Namen empfängt.
[out, optional] pcValues
Typ: LPDWORD
Die Adresse eines DWORD , das die Anzahl der Werte unter dem angegebenen Schlüssel empfängt.
[out, optional] pcchMaxValueNameLen
Typ: LPDWORD
Die Adresse eines DWORD , das die Anzahl der Zeichen im Namen des Werts mit dem größten Namen empfängt.
Rückgabewert
Typ: LSTATUS
Gibt bei erfolgreicher Ausführung ERROR_SUCCESS oder andernfalls einen in Winerror.h definierten Fehlercode ungleich null zurück. Sie können die FormatMessage-Funktion mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine Textbeschreibung des Fehlers abzurufen.
Hinweise
Hinweis
Der shlwapi.h-Header definiert SHQueryInfoKey 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 2000 Professional, Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | shlwapi.h |
Bibliothek | Shlwapi.lib |
DLL | Shlwapi.dll (Version 4.71 oder höher) |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für