Funzione OpenClusterNetworkEx (clusapi.h)

Articolo
08/22/2023

Apre una connessione a una rete e restituisce un handle.

Sintassi

HNETWORK OpenClusterNetworkEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszNetworkName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

Parametri

[in] hCluster

Gestire in un cluster.

[in, optional] lpszNetworkName

Puntatore al nome di una rete esistente.

[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 OpenClusterNetwork.

[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, OpenClusterNetworkEx restituisce un handle di rete.

Codice restituito	Descrizione
NULL	L'operazione non è riuscita. Per altre informazioni sull'errore, chiamare la funzione GetLastError . Se il server di destinazione non supporta la funzione OpenClusterNetworkEx ,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

Vedi anche

CloseClusterNetwork

Funzioni di gestione della rete del cluster di failover

OpenClusterNetwork

Condividi tramite