SHRegQueryInfoUSKeyA-Funktion (shlwapi.h)
Ruft Informationen zu einem angegebenen Registrierungsunterschlüssel in einer benutzerspezifischen Unterstruktur (HKEY_CURRENT_USER oder HKEY_LOCAL_MACHINE) ab.
Syntax
LSTATUS SHRegQueryInfoUSKeyA(
[in] HUSKEY hUSKey,
[out, optional] LPDWORD pcSubKeys,
[out, optional] LPDWORD pcchMaxSubKeyLen,
[out, optional] LPDWORD pcValues,
[out, optional] LPDWORD pcchMaxValueNameLen,
[in] SHREGENUM_FLAGS enumRegFlags
);
Parameter
[in] hUSKey
Typ: HUSKEY
Ein Handle für einen derzeit geöffneten Registrierungsunterschlüssel. Der Unterschlüssel muss mit dem Zugriffsrecht KEY_SET_VALUE geöffnet worden sein. Weitere Informationen finden Sie unter Sicherheit und Zugriffsrechte für Registrierungsschlüssel.
Dieses Handle kann über die SHRegOpenUSKey-Funktion abgerufen werden.
[out, optional] pcSubKeys
Typ: LPDWORD
Ein Zeiger auf ein DWORD , das die Anzahl von Unterschlüsseln unter dem angegebenen Schlüssel empfängt.
[out, optional] pcchMaxSubKeyLen
Typ: LPDWORD
Ein Zeiger auf ein DWORD , das die Anzahl der Zeichen im größten Unterschlüsselnamen empfängt.
[out, optional] pcValues
Typ: LPDWORD
Ein Zeiger auf ein DWORD , das die Anzahl der Werte unter dem angegebenen Schlüssel empfängt.
[out, optional] pcchMaxValueNameLen
Typ: LPDWORD
Ein Zeiger auf ein DWORD , das die Anzahl der Zeichen im größten Wertnamen empfängt.
[in] enumRegFlags
Typ: SHREGENUM_FLAGS
Einer der SHREGENUM_FLAGS , der den Basisschlüssel angibt, in dem die Abfrage erfolgen soll.
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 SHRegQueryInfoUSKey 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