Funzione OpenClusterNodeEx (clusapi.h)
Apre un nodo e restituisce un handle.
Sintassi
HNODE OpenClusterNodeEx(
[in] HCLUSTER hCluster,
[in, optional] LPCWSTR lpszNodeName,
[in] DWORD dwDesiredAccess,
[out, optional] DWORD *lpdwGrantedAccess
);
Parametri
[in] hCluster
Gestire in un cluster restituito dalle funzioni OpenCluster o OpenClusterEx .
[in, optional] lpszNodeName
Puntatore al nome NetBIOS di un nodo esistente. Se viene usato il nome DNS del nodo, la funzione OpenClusterNodeEx avrà esito negativo e GetLastError restituirà ERROR_CLUSTER_NODE_NOT_FOUND.
[in] dwDesiredAccess
Privilegi di accesso richiesti. Può trattarsi di qualsiasi combinazione di GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000) o MAXIMUM_ALLOWED (0x02000000). Se questo valore è zero (0) e potrebbe essere restituito un errore non definito. L'uso di GENERIC_ALL equivale a chiamare OpenClusterNode.
[out, optional] lpdwGrantedAccess
Parametro facoltativo che contiene l'indirizzo di un DWORD che riceverà i diritti di accesso concessi. Se il parametro DesiredAccess è MAXIMUM_ALLOWED (0x02000000), il DWORD a cui punta questo parametro conterrà i privilegi massimi concessi all'utente.
Valore restituito
Se l'operazione ha avuto esito positivo, OpenClusterNodeEx restituisce un handle di nodo.
| Codice restituito | Descrizione |
|---|---|
|
L'operazione non è riuscita. Per altre informazioni sull'errore, chiamare la funzione GetLastError . Se il server di destinazione non supporta la funzione OpenClusterNodeEx ,ad esempio se il server di destinazione esegue Windows Server 2008 o versioni precedenti, la funzione GetLastError restituirà RPC_S_PROCNUM_OUT_OF_RANGE (1745). |
Requisiti
| Client minimo supportato | Nessuno supportato |
| Server minimo supportato | Windows Server 2008 R2 Datacenter, Windows Server 2008 R2 Enterprise |
| Piattaforma di destinazione | Windows |
| Intestazione | clusapi.h |
| Libreria | ClusAPI.lib |
| DLL | ClusAPI.dll |