CreateCluster-Funktion (clusapi.h)

Erstellt und startet einen Cluster. Der Cluster besteht aus dem angegebenen Satz von Knoten, wobei der Netzwerkname, die IP-Adresse und die Quorumressourcen angegeben sind. Der typ PCLUSAPI_CREATE_CLUSTER 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
);

Die 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 dem PCLUSTER_SETUP_PROGRESS_CALLBACK Funktionszeiger entspricht, der in regelmäßigen Abständen aufgerufen wird, um Fortschritt bei der Clustererstellung bereitzustellen.

[in, optional] pvCallbackArg

Argument für die Rückruffunktion.

Rückgabewert

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

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

Bemerkungen

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 Cluster quorum 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
Mindestens unterstützter Client	Nicht unterstützt
Mindestanforderungen für unterstützte Server	Windows Server 2008 Datacenter, Windows Server 2008 Enterprise
Zielplattform	Fenster
Header	clusapi.h
Library	ClusAPI.lib
DLL	ClusAPI.dll

Siehe auch

AddClusterNode

CREATE_CLUSTER_CONFIG

Clusterverwaltungsfunktionen

DestroyCluster

PCLUSTER_SETUP_PROGRESS_CALLBACK