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

Article
02/26/2024

[Cette méthode est disponible pour une utilisation 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

En entrée, pointeur vers la taille de la mémoire tampon, en caractères, vers laquelle pointe le paramètre lpszName . Sur 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 des paramètres ne sont pas valides.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) 0x800700ea	La mémoire tampon pointée vers 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 a la valeur NULL et que le paramètre pcchName n’a pas la valeur NULL, la méthode GetClusterName retourne 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

IGetClusterDataInfo

Partager via