ClusterGroupOpenEnumEx-Funktion (clusapi.h)

Öffnet ein Handle für die Gruppenaufzählung. Der PCLUSAPI_CLUSTER_GROUP_OPEN_ENUM_EX Typ definiert einen Zeiger auf diese Funktion.

Syntax

HGROUPENUMEX ClusterGroupOpenEnumEx(
  [in] HCLUSTER hCluster,
       LPCWSTR  lpszProperties,
  [in] DWORD    cbProperties,
       LPCWSTR  lpszRoProperties,
  [in] DWORD    cbRoProperties,
  [in] DWORD    dwFlags
);

Parameter

[in] hCluster

Das Handle für den Cluster, für den die Enumeration ausgeführt wird.

lpszProperties

Ein Zeiger auf eine Liste von Namen allgemeiner Eigenschaften.

[in] cbProperties

Die Größe des LpszProperties-Felds in Bytes.

lpszRoProperties

Ein Zeiger auf eine Liste von Namen mit schreibgeschützten allgemeinen Eigenschaften.

[in] cbRoProperties

Die Größe des LpszRoProperties-Felds in Bytes.

[in] dwFlags

Für die zukünftige Verwendung reserviert. Der Wert muss 0 (null) sein.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ein Handle an die Enumeration zurück.

Wenn der Vorgang fehlschlägt, gibt die Funktion NULL zurück.

Hinweise

Die ClusterGroupOpenEnumEx-Funktion stellt eine Verbindung mit dem Clusterdienst über remote procedure call (RPC) her und erfasst alle Daten, um die gesamte Enumeration zu verarbeiten. Nach Abschluss des RPC-Aufrufs werden die Daten lokal verwaltet. Das HGROUPENUMEX-Handle enthält alle Daten, die zum Erfüllen der Enumeration erforderlich sind. Zusätzliche Aufrufe von ClusterGroupEnumEx oder ClusterGroupGetEnumCountEx stellen keine Verbindung mit dem Cluster her.

Anforderungen

Anforderung	Wert
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