OpenClusterNodeEx, fonction (clusapi.h)
Ouvre un nœud et lui retourne un handle.
Syntaxe
HNODE OpenClusterNodeEx(
[in] HCLUSTER hCluster,
[in, optional] LPCWSTR lpszNodeName,
[in] DWORD dwDesiredAccess,
[out, optional] DWORD *lpdwGrantedAccess
);
Paramètres
[in] hCluster
Gérez vers un cluster retourné à partir des fonctions OpenCluster ou OpenClusterEx .
[in, optional] lpszNodeName
Pointeur vers le nom NetBIOS d’un nœud existant. Si le nom DNS du nœud est utilisé, la fonction OpenClusterNodeEx échoue et GetLastError retourne ERROR_CLUSTER_NODE_NOT_FOUND.
[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 OpenClusterNode.
[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, OpenClusterNodeEx retourne un handle de nœud.
| 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 OpenClusterNodeEx (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 |