Fonction OnlineClusterGroupEx (clusapi.h)

Article
08/22/2023

Met un groupe en ligne.

Syntaxe

DWORD OnlineClusterGroupEx(
  [in]           HGROUP hGroup,
  [in, optional] HNODE  hDestinationNode,
  [in]           DWORD  dwOnlineFlags,
  [in, optional] PBYTE  lpInBuffer,
  [in]           DWORD  cbInBufferSize
);

Paramètres

[in] hGroup

Un handle pour le groupe à mettre en ligne.

[in, optional] hDestinationNode

Handle du nœud qui doit héberger le groupe.

[in] dwOnlineFlags

Indicateur qui spécifie les paramètres de la ressource à mettre en ligne.

CLUSAPI_GROUP_ONLINE_IGNORE_RESOURCE_STATUS (0x00000001)

Le serveur doit ignorer le mode verrouillé pour la ressource.

CLUSAPI_GROUP_ONLINE_SYNCHRONOUS (0x00000002)

Utilisez une opération synchrone pour mettre le groupe en ligne.

Windows Server 2012 R2 et Windows Server 2012 : Cette valeur a été ajoutée dans Windows Server 2016.

CLUSAPI_GROUP_ONLINE_BEST_POSSIBLE_NODE (0x00000004)

Laissez le service de cluster déterminer le nœud qui hébergera le groupe lors de sa mise en ligne.

Windows Server 2012 R2 et Windows Server 2012 : Cette valeur a été ajoutée dans Windows Server 2016.

0

Le serveur ne doit pas ignorer le mode verrouillé pour la ressource.

[in, optional] lpInBuffer

Pointeur vers la mémoire tampon d’entrée qui reçoit des instructions pour l’opération. Le paramètre lpInBuffer est mis en forme sous forme de liste de propriétés.

[in] cbInBufferSize

Taille du paramètre lpInBuffer , en octets.

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
ERROR_HOST_NODE_NOT_AVAILABLE	Un nœud hôte approprié n’était pas disponible.
ERROR_IO_PENDING	L’opération est en cours.

Configuration requise


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	clusapi.h
Bibliothèque	ClusAPI.lib
DLL	ClusAPI.dll

Voir aussi

Fonctions d’administration de groupe

Partager via