OpenCluster function (clusapi.h)
Opens a connection to a cluster and returns a handle to it.
Syntax
HCLUSTER OpenCluster(
[in, optional] LPCWSTR lpszClusterName
);
Parameters
[in, optional] lpszClusterName
Specifies one of the following values:
- Pointer to a null-terminated Unicode string containing the name of the cluster or one of the cluster nodes expressed as a NetBIOS name, a fully qualified DNS name, or an IP address. This produces an RPC cluster handle.
- NULL, which produces an LPC handle to the cluster to which the local computer belongs.
Return value
If the operation was successful, OpenCluster returns a cluster handle.
| Return code/value | Description |
|---|---|
|
The operation was not successful. For more information about the error, call the function GetLastError. |
Remarks
A cluster handle is a pointer to an internally defined structure which stores information about the RPC or LPC connection to the cluster. Any object handles obtained from the cluster handle will be associated with the RPC or LPC session data stored in the cluster structure. Combining RPC and LPC handles or using handles obtained from different contexts can cause exceptions or other unpredictable results. For more information, see LPC and RPC Handles.
When finished with a cluster handle, it is important to call CloseCluster to ensure that all memory is freed and the connection is shut down cleanly.
If the cluster is remote, the client must be running a compatible operating system. For example computers running Windows Server 2008 cannot call OpenCluster against a cluster running Windows Server 2016. To remotely manage these clusters, use the Failover Cluster WMI Provider.
Examples
See Using Object Handles.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | None supported |
| Minimum supported server | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Target Platform | Windows |
| Header | clusapi.h |
| Library | ClusAPI.lib |
| DLL | ClusAPI.dll |