SHQueryValueExA-Funktion (shlwapi.h)
Öffnet einen Registrierungsschlüssel und fragt ihn nach einem bestimmten Wert ab.
Syntax
LSTATUS SHQueryValueExA(
[in] HKEY hkey,
[in, optional] LPCSTR pszValue,
DWORD *pdwReserved,
[out, optional] DWORD *pdwType,
[out, optional] void *pvData,
[in, out, optional] DWORD *pcbData
);
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
[in, optional] pszValue
Typ: LPCTSTR
Die Adresse der NULL-endend-Zeichenfolge, die den Namen des abzufragenden Werts enthält.
pdwReserved
Typ: LPDWORD
Reserviert. Muss NULL sein.
[out, optional] pdwType
Typ: LPDWORD
Die Adresse der Variablen, die den Werttyp des Schlüssels empfängt. Weitere Informationen finden Sie unter Registrierungsdatentypen.
[out, optional] pvData
Typ: LPVOID
Die Adresse des Puffers, der die Daten des Werts empfängt. Dieser Parameter kann NULL sein, wenn die Daten nicht erforderlich sind.
[in, out, optional] pcbData
Typ: LPDWORD
Die Adresse der Variablen, die die Größe des Puffers in Bytes angibt, auf den der parameter pvData verweist. Wenn die Funktion zurückgibt, enthält diese Variable die Größe der in pvData kopierten Daten.
Rückgabewert
Art: DWORD
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 generische Beschreibung des Fehlers abzurufen.
Hinweise
Hinweis
Der shlwapi.h-Header definiert SHQueryValueEx 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 |
---|---|
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) |