Funzione OpenCluster (clusapi.h)
Apre una connessione a un cluster e restituisce un handle.
Sintassi
HCLUSTER OpenCluster(
[in, optional] LPCWSTR lpszClusterName
);
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 cluster RPC.
- NULL, che produce un handle LPC al cluster a cui appartiene il computer locale.
Valore restituito
Se l'operazione ha avuto esito positivo, OpenCluster restituisce un handle del cluster.
| Codice/valore restituito | Descrizione |
|---|---|
|
L'operazione non è riuscita. Per altre informazioni sull'errore, chiamare la funzione GetLastError. |
Commenti
Un handle del cluster è un puntatore a una struttura definita internamente che archivia le informazioni sulla connessione RPC o LPC al cluster. Tutti gli handle di oggetto 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 venga liberata e che la connessione venga arrestata correttamente.
Se il cluster è remoto, il client deve eseguire un sistema operativo compatibile. Ad esempio, i computer che eseguono Windows Server 2008 non possono chiamare OpenCluster su un cluster che esegue Windows Server 2016. Per gestire in remoto questi cluster, usare il provider WMI del cluster di failover.
Esempio
Vedere Uso di handle di oggetto.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Nessuno supportato |
| Server minimo supportato | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Piattaforma di destinazione | Windows |
| Intestazione | clusapi.h |
| Libreria | ClusAPI.lib |
| DLL | ClusAPI.dll |