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 |
---|---|
|
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 |