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 |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Es gibt keine weiteren Unterschlüssel, die zurückgegeben werden müssen. |
|
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. |
| 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 |