Fonction OpenClusterNetworkEx (clusapi.h)
Ouvre une connexion à un réseau et lui retourne un handle.
Syntaxe
HNETWORK OpenClusterNetworkEx(
[in] HCLUSTER hCluster,
[in, optional] LPCWSTR lpszNetworkName,
[in] DWORD dwDesiredAccess,
[out, optional] DWORD *lpdwGrantedAccess
);
Paramètres
[in] hCluster
Gérer vers un cluster.
[in, optional] lpszNetworkName
Pointeur vers le nom d’un réseau existant.
[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. Utiliser GENERIC_ALL revient à appeler OpenClusterNetwork.
[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 le nombre maximal de privilèges accordés à cet utilisateur.
Valeur retournée
Si l’opération a réussi, OpenClusterNetworkEx retourne un handle réseau.
| 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 OpenClusterNetworkEx (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 Entreprise |
| Plateforme cible | Windows |
| En-tête | clusapi.h |
| Bibliothèque | ClusAPI.lib |
| DLL | ClusAPI.dll |