Die Community zu .NET und Classic VB.
Menü

RegEnumKeyEx

 von 

Deklaration  

Declare Function RegEnumKeyEx Lib "advapi32.dll" _
                 Alias "RegEnumKeyExA" ( _
                 ByVal hKey As Long, _
                 ByVal dwIndex As Long, _
                 ByVal lpName As String, _
                 lpcbName As Long, _
                 ByVal lpReserved As Long, _
                 ByVal lpClass As String, _
                 lpcbClass As Long, _
                 lpftLastWriteTime As FILETIME) As Long
Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel RegEnumKeyEx des API-Wikis.

RegEnumKeyEx listet die Unterschlüssel eines Schlüssels auf.

Parameter
hKeyDer Schlüssel dessen Unterschlüssel 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 Unterschlüssel. Um auf den ersten Unterschlüssel zugreifen zu können, wird dieser Zähler auf Null gesetzt. Um den gesamten Unterschlüsselbaum aufzulisten, muß der Zähler vor jedem Aufruf inkrementiert werden, bis der Wert ERROR_NO_MORE_ITEMS zurückgegeben wird.
lpNameZeiger auf einen Puffer, der den Namen des aufgelisteten Unterschlüssels entgegennimmt. Der Name des Schlüssels ist nicht der vollständige Schlüssel, sondern der Unterschlüssel selbst.
lpcbNameLänge des Puffers lpName. 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 lpName kopiert wurden. Das Terminierungszeichen wird dabei nicht berücksichtigt.
lpReservedFür die zukünftige Implementierung reserviert. Dieser Wert wird auf Null gesetzt.
lpClassZeiger auf den Puffer, der den Klassennamen des Unterschlüssels aufnimmt. Die Anzahl der Zeichen die in diesen Puffer kopiert werden, wird im Parameter lpcbClass bereitgestellt. Dieser Paramter kann Null sein wenn kein Klassenname erforderlich ist.
lpcbClassLänge des Puffers lpClass. 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 lpClass kopiert wurden. Das Terminierungszeichen wird dabei nicht berücksichtigt. Dieser Parameter kann Null sein, wenn lpClass ebenfalls Null ist
lpftLastWriteTimeZeiger auf ein Feld, das das Datum und die Zeit des letzten Schreibvorganges für den Unterschlüssel enthält. Die FILETIME Struktur ist ein 64-Bit Wert, der die Anzahl der 100-Nanosekunden-Ticks seit dem 1. Januar 1601 angibt.

Tabelle 1


Rückgabewerte
ERROR_SUCCESDie Funktion wurde erfogreich ausgeführt.
ERROR_NO_MORE_ITEMSEs gibt keine weiteren Unterschlüssel für den Schlüssel.
xDer Fehlercode

Tabelle 2


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