ClusterRegEnumKey-Funktion (clusapi.h)

Listet die Unterschlüssel eines geöffneten Clusterdatenbankschlüssels auf.

Syntax

LONG ClusterRegEnumKey(
  [in]            HKEY      hKey,
  [in]            DWORD     dwIndex,
  [out]           LPWSTR    lpszName,
  [in, out]       LPDWORD   lpcchName,
  [out, optional] PFILETIME lpftLastWriteTime
);

Parameter

[in] hKey

HKEY , der einen derzeit geöffneten Schlüssel angibt.

[in] dwIndex

Index, der verwendet wird, um den nächsten Unterschlüssel zu identifizieren, der aufgelistet werden soll. Dieser Parameter sollte für den ersten Aufruf von ClusterRegEnumKey null sein und dann für nachfolgende Aufrufe inkrementiert werden.

Da Unterschlüssel nicht sortiert sind, verfügt jeder neue Unterschlüssel über einen beliebigen Index. Dies bedeutet, dass ClusterRegEnumKey Unterschlüssel in beliebiger Reihenfolge zurückgeben kann.

[out] lpszName

Zeiger auf einen Puffer, der den Namen des Unterschlüssels empfängt, einschließlich des NULL-Endzeichens. Die Funktion kopiert nur den Namen des Unterschlüssels, nicht die vollständige Schlüsselhierarchie, in den Puffer.

[in, out] lpcchName

Zeiger auf die Größe des lpszName-Puffers als Anzahl von Zeichen. Geben Sie bei der Eingabe die maximale Anzahl von Zeichen an, die der Puffer enthalten kann, einschließlich der endenden NULL. Gibt bei der Ausgabe die Anzahl der Zeichen im resultierenden Namen an, wobei der abschließende NULL-Wert ausgeschlossen wird.

[out, optional] lpftLastWriteTime

Zeiger auf die letzte Änderung des aufgezählten Unterschlüssels.

Rückgabewert

Die Funktion gibt einen der folgenden Werte zurück.

Rückgabecode/-wert	BESCHREIBUNG
ERROR_SUCCESS 0	Der Vorgang wurde durchgeführt.
ERROR_NO_MORE_ITEMS 259 (0x103)	Es gibt keine weiteren Unterschlüssel, die zurückgegeben werden müssen.
ERROR_MORE_DATA 234 (0xEA)	Der Puffer, auf den lpszName verweist, ist nicht groß genug, um das Ergebnis zu halten. Der lpcchName-Parameter gibt die Anzahl der Zeichen im Ergebnis zurück, wobei der beendende NULL-Wert ausgeschlossen wird.
Systemfehlercode	Fehler beim Vorgang.

Hinweise

Die ClusterRegEnumKey-Funktion ruft bei jedem Aufruf Informationen zu einem Unterschlüssel ab.

Da ClusterRegEnumKey Schlüssel aus dem Stamm der Datenbank auf dem Knoten auf dem Knoten aufzählt, auf dem die Anwendung ausgeführt wird, wenn hKey auf NULL festgelegt ist, schlägt ClusterRegEnumKey fehl, wenn der Knoten nicht Teil eines Clusters ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform	Windows
Kopfzeile	clusapi.h
Bibliothek	ClusAPI.lib
DLL	ClusAPI.dll

Weitere Informationen

Clusterregistrierungszugriffsfunktionen

ClusterRegOpenKey