Fonction OnlineClusterGroup (clusapi.h)
Met un groupe en ligne. Le type PCLUSAPI_ONLINE_CLUSTER_GROUP définit un pointeur vers cette fonction.
Syntaxe
DWORD OnlineClusterGroup(
[in] HGROUP hGroup,
[in, optional] HNODE hDestinationNode
);
Paramètres
[in] hGroup
Gérez le groupe à mettre en ligne.
[in, optional] hDestinationNode
Gérez vers le nœud où le groupe identifié par hGroup doit être mis en ligne ou NULL.
Valeur retournée
Si l’opération réussit, la fonction retourne ERROR_SUCCESS.
Si l’opération échoue, la fonction retourne un code d’erreur système. Voici les codes d’erreur possibles.
| Code de retour | Description |
|---|---|
|
Un nœud hôte approprié n’était pas disponible. |
|
L’opération est en cours. |
Remarques
Si le groupe ne peut pas être mis en ligne sur le nœud identifié par le paramètre hDestinationNode , la fonction OnlineClusterGroup échoue.
Si le paramètre hDestinationNode a la valeur NULL, OnlineClusterGroup met le groupe en ligne sur le nœud actuel.
N’appelez pas OnlineClusterGroup à partir d’une DLL de ressource. Pour plus d’informations, consultez Appels de fonction à éviter dans les DLL de ressources.
Ne passez pas de handles LPC et RPC au même appel de fonction. Sinon, l’appel déclenche une exception RPC et peut avoir des effets destructeurs supplémentaires. Pour plus d’informations sur la façon dont les handles LPC et RPC sont créés, consultez Utilisation de handles d’objet et OpenCluster.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2008 Entreprise, Windows Server 2008 Datacenter |
| Plateforme cible | Windows |
| En-tête | clusapi.h |
| Bibliothèque | ClusAPI.lib |
| DLL | ClusAPI.dll |