CreateCluster, fonction (clusapi.h)
Crée et démarre un cluster. Le cluster se compose de l’ensemble de nœuds spécifiés, avec le nom réseau, l’adresse IP et les ressources de quorum , le cas échéant. Le type PCLUSAPI_CREATE_CLUSTER définit un pointeur vers cette fonction.
Syntaxe
HCLUSTER CreateCluster(
[in] PCREATE_CLUSTER_CONFIG pConfig,
[in, optional] PCLUSTER_SETUP_PROGRESS_CALLBACK pfnProgressCallback,
[in, optional] PVOID pvCallbackArg
);
Paramètres
[in] pConfig
Adresse d’une structure de CREATE_CLUSTER_CONFIG contenant des informations de configuration sur le cluster à créer.
[in, optional] pfnProgressCallback
Adresse de la fonction de rappel qui correspond au pointeur de fonction PCLUSTER_SETUP_PROGRESS_CALLBACK qui sera appelé régulièrement pour fournir la progression de la création du cluster.
[in, optional] pvCallbackArg
Argument de la fonction de rappel.
Valeur retournée
Gérez le cluster nouvellement créé ou NULL. Une valeur non NULL n’indique pas la réussite complète (tous les nœuds auront été ajoutés, mais toutes les ressources d’adresse IP ou de nom réseau n’ont pas été créées. Les paramètres transmis à la fonction pointée par le paramètre pfnProgressCallback doivent être vérifiés .
| Code de retour | Description |
|---|---|
|
Moins d’une majorité des nœuds ont été créés avec succès. Pour plus d’informations sur l’erreur, appelez la fonction GetLastError. |
Remarques
Le type PCLUSAPI_CREATE_CLUSTER définit un pointeur vers cette fonction et peut être utilisé avec la fonction GetProcAddress pour appeler cette fonction.
Une fois la fonction CreateCluster terminée, au moins 30 secondes doivent être autorisées avant que la fonction AddClusterNode soit appelée pour ajouter des nœuds supplémentaires.
La fonction CreateCluster se termine correctement une fois le quorum de cluster atteint. Un ou plusieurs nœuds de cluster peuvent être dans un état ClusterNodeDown ou ClusterNodeJoining pendant quelques secondes.
Avant d’appeler la fonction CreateCluster , la fonction CoInitializeEx doit être appelée en spécifiant à la fois COINIT_MULTITHREADED et COINIT_DISABLE_OLE1DDE pour le paramètre dwCoInit , comme indiqué dans le code suivant.
CoInitializeEx( NULL, COINIT_MULTITHREADED | COINIT_DISABLE_OLE1DDE );
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2008 Datacenter, Windows Server 2008 Entreprise |
| Plateforme cible | Windows |
| En-tête | clusapi.h |
| Bibliothèque | ClusAPI.lib |
| DLL | ClusAPI.dll |