Funzione OpenClusterNetInterfaceEx (clusapi.h)
Apre un handle a un'interfaccia di rete.
Sintassi
HNETINTERFACE OpenClusterNetInterfaceEx(
[in] HCLUSTER hCluster,
[in, optional] LPCWSTR lpszInterfaceName,
[in] DWORD dwDesiredAccess,
[out, optional] DWORD *lpdwGrantedAccess
);
Parametri
[in] hCluster
Gestire in un cluster.
[in, optional] lpszInterfaceName
Puntatore a una stringa Unicode con terminazione null contenente il nome dell'interfaccia di rete da aprire.
[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 un errore non definito può essere restituito. L'uso di GENERIC_ALL corrisponde alla chiamata di OpenClusterNetInterface.
[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 esito positivo, OpenClusterNetInterfaceEx restituisce un handle aperto all'interfaccia di rete specificata.
| Codice restituito | Descrizione |
|---|---|
|
L'operazione non ha avuto esito positivo. Per altre informazioni sull'errore, chiamare la funzione GetLastError . Se il server di destinazione non supporta la funzione OpenClusterNetInterfaceEx , 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 |