Partager via


GetClusterNetworkId, fonction (clusapi.h)

Retourne l’identificateur d’un réseau. Le type PCLUSAPI_GET_CLUSTER_NETWORK_ID définit un pointeur vers cette fonction.

Syntaxe

DWORD GetClusterNetworkId(
  [in]      HNETWORK hNetwork,
  [out]     LPWSTR   lpszNetworkId,
  [in, out] LPDWORD  lpcchName
);

Paramètres

[in] hNetwork

Gérer sur un réseau.

[out] lpszNetworkId

Pointeur vers l’identificateur du réseau associé à hNetwork, y compris le caractère de fin null.

[in, out] lpcchName

Pointeur vers la taille de la mémoire tampon lpszNetworkID 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. Lors de 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 par lpszNetworkID n’est pas assez grande pour contenir le résultat. Le paramètre lpcchNetworkID retourne le nombre de caractères dans le résultat, à l’exclusion de la valeur NULL de fin.

Remarques

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

OpenClusterNetwork