Die Community zu .NET und Classic VB.
Menü

RegQueryValueEx

 von 

Deklaration  

Declare Function RegQueryValueEx Lib "advapi32.dll" _
                 Alias "RegQueryValueExA" ( _
                 ByVal hKey As Long, _
                 ByVal lpValueName As String, _
                 ByVal lpReserved As Long, _
                 lpType As Long, _
                 lpData As Any, _
                 lpcbData As Long) As Long
Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel RegQueryValueEx des API-Wikis.

RegQueryValueEx gibt einen benannten Wert eines Unterschlüssels zurück.

Parameter
hKeyDer Elternschlüssel des zu öffnenden Unterschlüssels. Dabei kann es sich um einen geöffneten Schlüssel oder einen der vor definfierten Hauptschlüssel HKEY_CLASSES_ROOT , HKEY_CURRENT_USER , HKEY_LOCAL_MACHINE , HKEY_USERS, HKEY_PERFORMANCE_DATA , HKEY_CURRENT_CONFIG , HKEY_DYN_DATA handeln.
lpValueNameZeiger auf einen Nullterminierten String der den Namen des zu lesenden Wertes enthält.
lpReservedWird auf Null gesetzt.
lpTypeDer Typ der im Wert gespeicherten Daten. Untenstehende Tabelle beschreibt die möglichen Variablentypen für die Werte.
lpDataZeiger auf einen Puffer der die Daten entgegennimmt, die in dem Wert gespeichert sind.
lpcbDataAnzahl der Bytes die in lpData zur Verfügung stehen. Nach dem aufruf setzt das System den Inhalt auf die Anzahl der tatsächlich kopierten Bytes.

Tabelle 1


Registry Datentypen
REG_BINARYBinärdaten in beliebigem Format.
REG_DWORDEine 32-Bit Zahl im ursprünglichen Format.
REG_DWORD_LITTLE_ENDIANEine 32-Bit Zahl im Little-Endian-Format (wie REG_DWORD ). In diesem Format ist das obere Byte eines Wortes das höherwertige Byte.
REG_DWORD_BIG_ENDIANEine 32-Bit Zahl im Big-Endian-Format (wie REG_DWORD ). In diesem Format ist das untere Byte eines Wortes das höherwertige Byte.
REG_EXPAND_SZEin nullterminierter String, der nicht aufgelöste Verweise auf Umgebungsvariablen enthält (z.B. %PATH%). Win9x erlaubt, daß diese Strings gespeichert werden. Sie werden nicht automatisch expandiert.
REG_LINKEin symbolischer Link zu einem anderen Unterschlüssel.
REG_MULTI_SZEine Liste nullterminierter Strings, die durch ein weiteres Nullzeichen beendet wird.
REG_NONEEin nicht definierter Typ.
REG_SZEin nullterminierter String.

Tabelle 2


Rückgabewerte
ERROR_SUCCESSDer Schlüssel wurde erfolgreich geschlossen.
xDer zugehörige Fehlercode

Tabelle 3


Unterstützte Betriebssysteme
Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
ExpandEnvironmentStrings, RegCreateKeyEx, RegEnumKey, RegEnumKeyEx, RegEnumValue, RegOpenKeyEx, RegQueryInfoKey, RegQueryValue

Zugehörige Tipps

Zugehörige Microsoft Knowledge Base Artikel