Fonction OnlineClusterResourceEx (clusapi.h)

Article
08/22/2023

Met en ligne une ressource hors connexion ou ayant échoué.

Syntaxe

DWORD OnlineClusterResourceEx(
  [in]           HRESOURCE hResource,
  [in]           DWORD     dwOnlineFlags,
  [in, optional] PBYTE     lpInBuffer,
  [in]           DWORD     cbInBufferSize
);

Paramètres

[in] hResource

Handle de la ressource à mettre en ligne.

[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_RESOURCE_ONLINE_DO_NOT_UPDATE_PERSISTENT_STATE (0x00000002)

Ne mettez pas à jour l’état persistant de la ressource.

CLUSAPI_RESOURCE_ONLINE_NECESSARY_FOR_QUORUM (0x00000004)

La ressource doit être mise en ligne pour conserver un quorum.

CLUSAPI_RESOURCE_ONLINE_BEST_POSSIBLE_NODE (0x00000008)

Le service de cluster consiste à déterminer le nœud qui hébergera la ressource lorsqu’elle sera mise en ligne.

Windows Server 2012 R2 et Windows Server 2012 : cette valeur n’est pas prise en charge avant 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 au format liste de propriétés.

[in] cbInBufferSize

Taille de 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 un code d’erreur possible.

Code de retour	Description
ERROR_IO_PENDING	La ressource ou l’une des ressources dont elle dépend a retourné ERROR_IO_PENDING à partir de sa fonction de point d’entrée en ligne .

Configuration requise

Condition requise	Valeur
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 de gestion des ressources du cluster de basculement

Partager via