GetClusterNetInterface, fonction (clusapi.h)

Article
02/24/2024

Retourne le nom de l’interface d’un nœud à un réseau dans un cluster. Le type PCLUSAPI_GET_CLUSTER_NET_INTERFACE définit un pointeur vers cette fonction.

Syntaxe

DWORD GetClusterNetInterface(
  [in]      HCLUSTER hCluster,
  [in]      LPCWSTR  lpszNodeName,
  [in]      LPCWSTR  lpszNetworkName,
  [out]     LPWSTR   lpszInterfaceName,
  [in, out] LPDWORD  lpcchInterfaceName
);

Paramètres

[in] hCluster

Gérer vers un cluster.

[in] lpszNodeName

Pointeur vers une chaîne Unicode terminée par null contenant le nom du nœud dans le cluster.

[in] lpszNetworkName

Pointeur vers une chaîne Unicode terminée par null contenant le nom du réseau.

[out] lpszInterfaceName

Pointeur vers une mémoire tampon de sortie contenant le nom de l’interface réseau.

[in, out] lpcchInterfaceName

Pointeur vers la taille de la mémoire tampon lpszInterfaceName 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. Sur la sortie, spécifie le nombre de caractères dans le nom résultant, à l’exclusion de la valeur NULL de fin.

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 pointée vers lpszInterfaceName n’est pas assez grande pour contenir le résultat. Le paramètre lpcchInterfaceName retourne le nombre de caractères dans le résultat, à l’exclusion de la valeur NULL de fin.

Remarques

Notez que lpcchInterfaceName 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

OpenCluster

Partager via