Die Community zu .NET und Classic VB.
Menü

RegEnumValue

 von 

Deklaration  

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

Parameter
hKeyDer Unterschlüssel dessen Werte aufgelistet werden sollen. 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.
dwIndexDer Zähler für den Zugriff auf die Werte. Um auf den ersten Wert zugreifen zu können, wird dieser Zähler auf Null gesetzt. Um die gesamten Werte des Unterschlüssels aufzulisten, muß der Zähler vor jedem Aufruf inkrementiert werden, bis der Wert ERROR_NO_MORE_VALUES zurückgegeben wird.
lpValueNameZeiger auf den Puffer, der den Namen des Wertes aufnimmt.
lpcbValueNameLänge des Puffers lpValueName. Das System versucht die angegebene Anzahl an Zeichen des Unterschlüssels in den Puffer zu kopieren. Der Zähler muß ein Byte für das Terminierungszeichen beinhalten. Nach dem Aufruf wird der Wert in die Anzahl der Zeichen geändert, die in den String lpValueName kopiert wurden. Das Terminierungszeichen wird dabei nicht berücksichtigt.
lpReservedReserviert, dieser Paramter muß auf Null gesetzt werden.
lpTypeGibt den Datentyp des abgefragten Wertes wieder. Dieses Feld kann Null sein, wenn der Datentyp nicht benötigt wird.
lpDataZeiger auf einen Puffer der den Inhalt des Wertes aufnimmt.
lpcbDataEnthält die Anzahl der Bytes im Puffer lpData. Wenn lpData gleich Null ist, kann dieser Parameter ebenfalls Null sein.

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_SUCCESDie Funktion wurde erfogreich ausgeführt.
ERROR_NO_MORE_VALUESEs gibt keine weiteren Unterschlüssel für den Schlüssel.
xDer Fehlercode

Tabelle 3


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

Verwandte API-Funktionen
RegCreateKeyEx, RegDeleteKey, RegEnumKey, RegOpenKeyEx, RegQueryInfoKey

Zugehörige Tipps

Zugehörige Microsoft Knowledge Base Artikel