CreateCluster-Funktion (clusapi.h)

Erstellt und startet einen Cluster. Der Cluster besteht aus der angegebenen Gruppe von Knoten mit den Ressourcen Netzwerkname, IP-Adresse und Quorum , sofern angegeben. Der PCLUSAPI_CREATE_CLUSTER Typ definiert einen Zeiger auf diese Funktion.

Syntax

HCLUSTER CreateCluster(
  [in]           PCREATE_CLUSTER_CONFIG           pConfig,
  [in, optional] PCLUSTER_SETUP_PROGRESS_CALLBACK pfnProgressCallback,
  [in, optional] PVOID                            pvCallbackArg
);

Parameter

[in] pConfig

Adresse einer CREATE_CLUSTER_CONFIG-Struktur , die Konfigurationsinformationen zum zu erstellenden Cluster enthält.

[in, optional] pfnProgressCallback

Adresse der Rückruffunktion, die mit dem PCLUSTER_SETUP_PROGRESS_CALLBACK Funktionszeiger übereinstimmt, der regelmäßig aufgerufen wird, um den Fortschritt bei der Clustererstellung bereitzustellen.

[in, optional] pvCallbackArg

Argument für die Rückruffunktion.

Rückgabewert

Handle für den neu erstellten Cluster oder NULL. Ein Wert ungleich NULL gibt nicht den vollständigen Erfolg an (alle Knoten wurden hinzugefügt, aber möglicherweise wurden nicht alle IP-Adress- oder Netzwerknamenressourcen erstellt. Die Parameter, die an die Funktion übergeben werden, auf die der Parameter pfnProgressCallback verweist, sollten überprüft werden.

Rückgabecode	Beschreibung
NULL	Weniger als eine Mehrheit der Knoten wurde erfolgreich erstellt. Rufen Sie die Funktion GetLastError auf, um weitere Informationen zum Fehler zu erhalten.

Hinweise

Der PCLUSAPI_CREATE_CLUSTER Typ definiert einen Zeiger auf diese Funktion und kann mit der GetProcAddress-Funktion verwendet werden, um diese Funktion aufzurufen.

Nachdem die CreateCluster-Funktion erfolgreich abgeschlossen wurde, sollten mindestens 30 Sekunden zulässig sein, bevor die AddClusterNode-Funktion aufgerufen wird, um weitere Knoten hinzuzufügen.

Die CreateCluster-Funktion wird erfolgreich abgeschlossen, nachdem das Clusterquorum erreicht wurde. Mindestens ein Clusterknoten kann sich für einige Sekunden in einem ClusterNodeDown - oder ClusterNodeJoining-Zustand befinden.

Vor dem Aufrufen der CreateCluster-Funktion muss die CoInitializeEx-Funktion aufgerufen werden, die sowohl COINIT_MULTITHREADED als auch COINIT_DISABLE_OLE1DDE für den dwCoInit-Parameter angibt, wie im folgenden Code gezeigt.

CoInitializeEx( NULL, COINIT_MULTITHREADED | COINIT_DISABLE_OLE1DDE );

Anforderungen

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

Weitere Informationen

AddClusterNode

CREATE_CLUSTER_CONFIG

Clusterverwaltungsfunktionen

DestroyCluster

PCLUSTER_SETUP_PROGRESS_CALLBACK