OpenClusterNetInterfaceEx, fonction (clusapi.h)
Ouvre un handle sur une interface réseau.
Syntaxe
HNETINTERFACE OpenClusterNetInterfaceEx(
[in] HCLUSTER hCluster,
[in, optional] LPCWSTR lpszInterfaceName,
[in] DWORD dwDesiredAccess,
[out, optional] DWORD *lpdwGrantedAccess
);
Paramètres
[in] hCluster
Gérer vers un cluster.
[in, optional] lpszInterfaceName
Pointeur vers une chaîne Unicode terminée par un caractère Null contenant le nom de l’interface réseau à ouvrir.
[in] dwDesiredAccess
Privilèges d’accès demandés. Il peut s’agir d’une combinaison de GENERIC_READ (0x80000000), de GENERIC_ALL (0x10000000) ou de MAXIMUM_ALLOWED (0x02000000). Si cette valeur est égale à zéro (0) et qu’une erreur non définie peut être retournée. L’utilisation de GENERIC_ALL revient à appeler OpenClusterNetInterface.
[out, optional] lpdwGrantedAccess
Paramètre facultatif qui contient l’adresse d’un DWORD qui recevra les droits d’accès accordés. Si le paramètre DesiredAccess est MAXIMUM_ALLOWED (0x02000000), le DWORD pointé par ce paramètre contiendra les privilèges maximum accordés à cet utilisateur.
Valeur retournée
Si l’opération a réussi, OpenClusterNetInterfaceEx retourne un handle ouvert à l’interface réseau spécifiée.
| Code de retour | Description |
|---|---|
|
L’opération n’a pas réussi. Pour plus d’informations sur l’erreur, appelez la fonction GetLastError . Si le serveur cible ne prend pas en charge la fonction OpenClusterNetInterfaceEx (par exemple, si le serveur cible exécute Windows Server 2008 ou une version antérieure), la fonction GetLastError retourne RPC_S_PROCNUM_OUT_OF_RANGE (1745). |
Configuration requise
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2008 R2 Datacenter, Windows Server 2008 R2 Enterprise |
| Plateforme cible | Windows |
| En-tête | clusapi.h |
| Bibliothèque | ClusAPI.lib |
| DLL | ClusAPI.dll |