OpenClusterNode function (clusapi.h)

Opens a node and returns a handle to it. The PCLUSAPI_OPEN_CLUSTER_NODE type defines a pointer to this function.

Syntax

HNODE OpenClusterNode(
  [in] HCLUSTER hCluster,
  [in] LPCWSTR  lpszNodeName
);

Parameters

[in] hCluster

Handle to a cluster returned from the OpenCluster or OpenClusterEx functions.

[in] lpszNodeName

Pointer to the NetBIOS name of an existing node. If the DNS name of the node is used, the OpenClusterNode function will fail and GetLastError will return ERROR_CLUSTER_NODE_NOT_FOUND.

Return value

If the operation was successful, OpenClusterNode returns a node handle.

Return code Description
NULL
The operation was not successful. For more information about the error, call the function GetLastError.

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

See also

CloseClusterNode

Node Management Functions

OpenCluster

OpenClusterEx

OpenClusterNodeEx