GetClusterQuorumResource, fonction (clusapi.h)

Article
03/01/2024

Retourne le nom de la ressource de quorum d’un cluster. Le type PCLUSAPI_GET_CLUSTER_QUORUM_RESOURCE définit un pointeur vers cette fonction.

Syntaxe

DWORD GetClusterQuorumResource(
  [in]      HCLUSTER hCluster,
  [out]     LPWSTR   lpszResourceName,
  [in, out] LPDWORD  lpcchResourceName,
  [out]     LPWSTR   lpszDeviceName,
  [in, out] LPDWORD  lpcchDeviceName,
  [out]     LPDWORD  lpdwMaxQuorumLogSize
);

Paramètres

[in] hCluster

Gérez vers un cluster existant.

[out] lpszResourceName

Pointeur vers une chaîne Unicode terminée par un caractère Null contenant le nom de la ressource de quorum du cluster. Le nom est lu à partir de la propriété Name common de la ressource de quorum. Ne passez pas null pour ce paramètre.

[in, out] lpcchResourceName

Pointeur vers la taille de la mémoire tampon lpszResourceName en tant que nombre de caractères. Lors de l’entrée, spécifiez le nombre maximal de caractères que la mémoire tampon peut contenir, y compris la valeur NULL de fin. Lors de la sortie, spécifie le nombre de caractères dans le nom résultant, à l’exclusion de la valeur NULL de fin.

[out] lpszDeviceName

Pointeur vers une chaîne Unicode terminée par null contenant le chemin d’accès à l’emplacement des fichiers journaux de quorum gérés par le service de cluster. Ne passez pas null pour ce paramètre.

[in, out] lpcchDeviceName

Pointeur vers la taille de la mémoire tampon lpszDeviceName en tant que nombre de caractères. Lors de l’entrée, spécifiez le nombre maximal de caractères que la mémoire tampon peut contenir, y compris la valeur NULL de fin. Lors de la sortie, spécifie le nombre de caractères dans le nom résultant, à l’exclusion de la valeur NULL de fin.

[out] lpdwMaxQuorumLogSize

Pointeur vers la taille maximale (en octets) du journal géré par la ressource de quorum. Ne passez pas null pour ce paramètre.

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 l’une des valeurs possibles.

Code de retour	Description
ERROR_MORE_DATA	La mémoire tampon lpszResourceName ou lpszDeviceName n’est pas assez grande pour contenir le résultat. Les paramètres lpcchResourceName et lpcchDeviceName retournent le nombre de caractères dans le résultat, à l’exclusion de la valeur NULL de fin.

Remarques

Notez que lpcchName fait référence à un nombre de caractères et non à un nombre d’octets, et que la taille retournée n’inclut pas la valeur NULL de fin dans le nombre. Pour plus d’informations sur le dimensionnement des mémoires tampons, consultez Conventions de taille des données.

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

Nom

SetClusterQuorumResource

Partager via