Partager via


Fonction CreateClusterGroup (clusapi.h)

Ajoute un groupe à un cluster et retourne un handle au groupe qui vient d’être ajouté. Le type PCLUSAPI_CREATE_CLUSTER_GROUP définit un pointeur vers cette fonction.

Syntaxe

HGROUP CreateClusterGroup(
  [in] HCLUSTER hCluster,
  [in] LPCWSTR  lpszGroupName
);

Paramètres

[in] hCluster

Gérez le cluster cible.

[in] lpszGroupName

Pointeur vers une chaîne Unicode terminée par null contenant le nom du groupe à ajouter au cluster identifié par hCluster. S’il n’existe pas de groupe de ce nom, CreateClusterGroup le crée.

Valeur retournée

Si l’opération réussit, la fonction retourne un handle de groupe.

Si l’opération échoue, la fonction retourne NULL. Pour plus d’informations sur l’erreur, appelez GetLastError.

Remarques

N’appelez pas CreateClusterGroup à partir d’une DLL de ressource. Pour plus d’informations, consultez Appels de fonction à éviter dans les DLL de ressources.

La fonction CreateClusterGroup appelle la fonction CreateClusterGroupEx avec un CLUSTER_CREATE_GROUP_INFO NULL . Le nouveau groupe est créé avec un type de groupe ClusGroupTypeUnknown.

Exemples

Consultez Création de groupes.

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

Voir aussi

OpenClusterGroup