Méthode IGetClusterObjectInfo::GetObjectName (cluadmex.h)
[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 d’un objet de cluster.
Syntaxe
HRESULT GetObjectName(
[in] LONG lObjIndex,
[out] BSTR lpszName,
[in, out] LONG *pcchName
);
Paramètres
[in] lObjIndex
Nombre représentant l’index de base zéro de l’objet cible. lObjIndex est limité au numéro qui peut être récupéré en appelant IGetClusterDataInfo::GetObjectCount.
[out] lpszName
Pointeur vers une chaîne Unicode terminée par null contenant le nom de l’objet associé à lObjIndex. Le paramètre lpszName peut être NULL, ce qui indique 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, pointez vers le nombre de caractères dans la mémoire tampon pointée vers le paramètre lpszName . Le paramètre pcchName ne peut pas être NULL. Sur la sortie, pointeur vers le nombre de caractères dans le nom stocké dans le contenu de lpszName, y compris le caractère de fin NULL.
Valeur retournée
Si GetObjectName échoue, il peut retourner d’autres valeurs HRESULT .
| Code/valeur de retour | Description |
|---|---|
|
L'opération a réussi. |
|
Un ou plusieurs des paramètres ne sont pas valides. |
|
La mémoire tampon pointée vers lpszName est trop petite pour contenir le nom demandé. GetObjectName retourne le nombre de caractères requis dans le contenu de pcchName. |
Remarques
Si le paramètre lpszName est spécifié comme NULL, la méthode GetObjectName retourne NOERROR.
Configuration requise
| 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 |