Funzione OpenClusterEx (clusapi.h)

Articolo
08/22/2023

Apre una connessione a un cluster e restituisce un handle.

Sintassi

HCLUSTER OpenClusterEx(
  [in, optional]  LPCWSTR lpszClusterName,
  [in]            DWORD   DesiredAccess,
  [out, optional] DWORD   *GrantedAccess
);

Parametri

[in, optional] lpszClusterName

Specifica uno dei valori seguenti:

Puntatore a una stringa Unicode con terminazione null contenente il nome del cluster o uno dei nodi del cluster espressi come nome NetBIOS, un nome DNS completo o un indirizzo IP. In questo modo viene generato un handle del cluster RPC.
NULL, che produce un handle LPC nel cluster a cui appartiene il computer locale.

[in] DesiredAccess

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 OpenCluster.

[out, optional] GrantedAccess

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, OpenClusterEx restituisce un handle del cluster.

Codice/valore restituito	Descrizione
NULL 0	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 OpenClusterEx , 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).

Commenti

Un handle del cluster è un puntatore a una struttura definita internamente che archivia informazioni sulla connessione RPC o LPC al cluster. Tutti gli handle di oggetti ottenuti dall'handle del cluster verranno associati ai dati della sessione RPC o LPC archiviati nella struttura del cluster. La combinazione di handle RPC e LPC o l'uso di handle ottenuti da contesti diversi può causare eccezioni o altri risultati imprevedibili. Per altre informazioni, vedere Handle LPC e RPC.

Al termine di un handle del cluster, è importante chiamare CloseCluster per assicurarsi che tutta la memoria sia liberata e che la connessione venga arrestata in modo pulito.

Requisiti

Requisito	Valore
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

Condividi tramite