Méthode IGetClusterResourceInfo ::GetResourceNetworkName (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 du réseau géré par la ressource Nom du réseau dont dépend une ressource .
Syntaxe
BOOL GetResourceNetworkName(
[in] LONG lObjIndex,
[out] BSTR lpszNetName,
[in, out] ULONG *pcchNetName
);
Paramètres
[in] lObjIndex
Nombre représentant l’index de base zéro de la ressource cible. La ressource cible peut dépendre ou non d’une ressource nom de réseau. lObjIndex est limité au numéro qui peut être récupéré en appelant IGetClusterDataInfo ::GetObjectCount.
[out] lpszNetName
Pointeur vers une chaîne Unicode terminée par null contenant le nom du réseau dont dépend la ressource indexée par lObjIndex . Bien que déclaré en tant que BSTR, ce paramètre est implémenté en tant que LPWSTR.
[in, out] pcchNetName
Pointeur vers le nombre maximal de caractères de la mémoire tampon pointée par lpszNetName. En entrée, cette valeur doit être suffisamment grande pour contenir MAX_COMPUTERNAME_LENGTH + 1 caractères. Lors de la sortie, pcchNetName pointe vers le nombre réel de caractères copiés dans le contenu de lpszNetName.
Valeur retournée
| Code/valeur de retour | Description |
|---|---|
|
La ressource indexée par lObjIndex a une dépendance sur une ressource Nom de réseau, et le nom du réseau a été retourné avec succès. |
|
La ressource indexée par lObjIndex n’a pas de dépendance sur une ressource Network Name. |
Remarques
La méthode GetResourceNetworkName est nécessaire pour autoriser les pages de propriétés d’extension Administrateur du cluster de basculement à déterminer si une ressource a une dépendance existante ou en attente sur une ressource nom de réseau.
Le nom du réseau est stocké dans la propriété privée Name de la ressource Nom du réseau. La propriété nom commun de la ressource Nom du réseau est le nom de la ressource, et non le réseau.
MAX_COMPUTERNAME_LENGTH est une constante définie comme 15 dans le fichier d’en-tête Windows WinBase.h.
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 |