Freigeben über


ClusterResourceEnumEx-Funktion (clusapi.h)

Listet eine Ressource auf und gibt dann einen Zeiger auf die aktuelle abhängige Ressource oder den aktuellen abhängigen Knoten zurück.

Syntax

DWORD ClusterResourceEnumEx(
  [in]      HRESENUMEX                  hResourceEnumEx,
  [in]      DWORD                       dwIndex,
  [in, out] PCLUSTER_RESOURCE_ENUM_ITEM pItem,
  [in, out] LPDWORD                     cbItem
);

Parameter

[in] hResourceEnumEx

Ein Handle für eine Ressourcenaufzählung, die von der ClusterResourceOpenEnumEx-Funktion zurückgegeben wird.

[in] dwIndex

Der Index der zurückzugebenden Ressource oder des Knotenobjekts. Dieser Parameter sollte für den ersten Aufruf der ClusterResourceEnumEx-Funktion null und dann sein.
für nachfolgende Aufrufe erhöht.

[in, out] pItem

Ein Zeiger, der das zurückgegebene Objekt empfängt.

[in, out] cbItem

Bei der Eingabe die Größe des pItem-Parameters .

Bei der Ausgabe entweder die erforderliche Größe in Bytes des Puffers, wenn der Puffer zu klein ist, oder die Anzahl der in den Puffer geschriebenen Bytes.

Rückgabewert

Die Funktion gibt einen der folgenden Werte zurück.

Rückgabecode/-wert BESCHREIBUNG
ERROR_SUCCESS
0
Der Vorgang wurde erfolgreich abgeschlossen, oder der lpszName-Parameter ist NULL.
ERROR_MORE_DATA
234 (0xEA)
Der Puffer, auf den der lpszName-Parameter verweist, ist nicht groß genug, um das Ergebnis zu halten. Der Parameter lpcchName gibt die Anzahl der Zeichen im Ergebnis zurück, wobei das beendende NULL-Zeichen ausgeschlossen wird.
ERROR_NO_MORE_ITEMS
259 (0x103)
Es gibt keine weiteren Objekte, die zurückgegeben werden müssen.
Systemfehlercode
Jeder andere zurückgegebene Fehlercode gibt an, dass der Vorgang fehlgeschlagen ist.

Anforderungen

   
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Windows
Kopfzeile clusapi.h
Bibliothek ClusAPI.lib
DLL ClusAPI.dll

Weitere Informationen

ClusterResourceOpenEnumEx

Ressourcenverwaltungsfunktionen des Failoverclusters