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