Méthode IGetClusterUIInfo ::GetClusterName (cluadmex.h)

Article
02/26/2024

[Cette méthode peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. La prise en charge de cette méthode a été supprimée dans Windows Server 2008.]

Retourne le nom du cluster.

Syntaxe

HRESULT GetClusterName(
  [out]     BSTR lpszName,
  [in, out] LONG *pcchName
);

Paramètres

[out] lpszName

Pointeur vers une chaîne Unicode terminée par null contenant le nom du cluster ou NULL pour indiquer que l’appelant demande uniquement la longueur du nom. Bien que déclaré en tant que BSTR, ce paramètre est implémenté en tant que LPWSTR.

[in, out] pcchName

Lors de l’entrée, pointeur vers le nombre de caractères dans la mémoire tampon vers laquelle pointe le paramètre lpszName . Dans la sortie, pointez vers le nombre total de caractères dans la mémoire tampon, y compris le caractère de fin NULL.

Valeur retournée

Si GetClusterName échoue, il peut retourner d’autres valeurs HRESULT .

Code/valeur de retour	Description
NOERROR 0	L'opération a réussi.
E_INVALIDARG 0x80070057	Un ou plusieurs paramètres ne sont pas valides.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) 0x800700ea	La mémoire tampon pointée par lpszName est trop petite pour contenir le nom demandé. GetClusterName retourne le nombre de caractères requis dans le contenu de pcchName.

Remarques

Si le paramètre lpszName est défini sur NULL et que le paramètre pcchName n’est pas défini sur NULL, la méthode GetClusterName renvoie NOERROR.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 Entreprise, Windows Server 2003 Datacenter
Plateforme cible	Windows
En-tête	cluadmex.h

Voir aussi

IGetClusterUIInfo

Partager via