RegEnumValue

von ActiveVB-Team

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
hKey	Der 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.
dwIndex	Der 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.
lpValueName	Zeiger auf den Puffer, der den Namen des Wertes aufnimmt.
lpcbValueName	Lä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.
lpReserved	Reserviert, dieser Paramter muß auf Null gesetzt werden.
lpType	Gibt den Datentyp des abgefragten Wertes wieder. Dieses Feld kann Null sein, wenn der Datentyp nicht benötigt wird.
lpData	Zeiger auf einen Puffer der den Inhalt des Wertes aufnimmt.
lpcbData	Enthält die Anzahl der Bytes im Puffer lpData. Wenn lpData gleich Null ist, kann dieser Parameter ebenfalls Null sein.

Tabelle 1

Registry Datentypen
REG_BINARY	Binärdaten in beliebigem Format.
REG_DWORD	Eine 32-Bit Zahl im ursprünglichen Format.
REG_DWORD_LITTLE_ENDIAN	Eine 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_ENDIAN	Eine 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_SZ	Ein 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_LINK	Ein symbolischer Link zu einem anderen Unterschlüssel.
REG_MULTI_SZ	Eine Liste nullterminierter Strings, die durch ein weiteres Nullzeichen beendet wird.
REG_NONE	Ein nicht definierter Typ.
REG_SZ	Ein nullterminierter String.

Tabelle 2

Rückgabewerte
ERROR_SUCCES	Die Funktion wurde erfogreich ausgeführt.
ERROR_NO_MORE_VALUES	Es gibt keine weiteren Unterschlüssel für den Schlüssel.
x	Der Fehlercode

Tabelle 3

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

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

Zugehörige Tipps

In der Registry browsen [Tipp 0209]

Zugehörige Microsoft Knowledge Base Artikel