Fonction SetClusterQuorumResource (clusapi.h)

Article
02/26/2024

Établit une ressource en tant que ressource de quorum pour un cluster. Le type PCLUSAPI_SET_CLUSTER_QUORUM_RESOURCE définit un pointeur vers cette fonction.

Syntaxe

DWORD SetClusterQuorumResource(
  [in]           HRESOURCE hResource,
  [in, optional] LPCWSTR   lpszDeviceName,
  [in]           DWORD     dwMaxQuoLogSize
);

Paramètres

[in] hResource

Gérer vers la nouvelle ressource de quorum ; ou la ressource de quorum existante lorsque dwMaxQuoLogSize est CLUS_NODE_MAJORITY_QUORUM.

[in, optional] lpszDeviceName

Détermine la lettre de lecteur et le chemin que le service de cluster utilisera pour gérer les fichiers de quorum sur la nouvelle ressource de quorum. Transmettez une chaîne Unicode terminée par null ou NULL, comme suit.

Si vous spécifiez une lettre de lecteur dans le chemin d’accès, le service cluster vérifie que la lettre de lecteur fait référence à une partition valide sur la nouvelle ressource de quorum.
Si vous ne spécifiez pas de lettre de lecteur dans le chemin d’accès, le service cluster utilise une partition par défaut sur la nouvelle ressource de quorum (voir ci-dessous).
Si la valeur est NULL, le service de cluster utilise une partition par défaut et un nom de chemin d’accès par défaut (voir ci-dessous).

Le service cluster utilise la partition marquée comme CLUSPROP_PIFLAG_DEFAULT_QUORUM comme partition par défaut (voir CLUSPROP_PARTITION_INFO) ou, si l’indicateur est introuvable, la première partition NTFS disponible sur la nouvelle ressource de quorum.

Pour le nom de chemin d’accès par défaut, le service de cluster utilise le nom de chemin d’accès précédent s’il en existe un ; sinon, il utilise « MSCS ».

[in] dwMaxQuoLogSize

Valeur de type quorum. Spécifiez l’une des trois constantes répertoriées. Lorsque vous spécifiez CLUS_NODE_MAJORITY_QUORUM, hResource doit faire référence à la ressource de quorum existante.

CLUS_HYBRID_QUORUM (1024 (0x400))

CLUS_NODE_MAJORITY_QUORUM (0 (0x0))

CLUS_LEGACY_QUORUM (4194304 (0x400000))

Valeur retournée

Si l’opération réussit, la fonction retourne ERROR_SUCCESS (0).

Si l’opération échoue, la fonction retourne un code d’erreur système. Voici un code d’erreur possible.

Code/valeur de retour	Description
ERROR_RESOURCE_NOT_ONLINE 5004 (0x138C)	La ressource quorum n’est pas en ligne.

Remarques

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

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

GetClusterQuorumResource

Partager via