ClusterNodeEnumEx function (clusapi.h)

Retrieves the specified cluster node from a CLUSTER_ENUM_ITEM enumeration.


DWORD ClusterNodeEnumEx(
  [in]      HNODEENUMEX        hNodeEnum,
  [in]      DWORD              dwIndex,
  [in, out] PCLUSTER_ENUM_ITEM pItem,
  [in, out] LPDWORD            cbItem


[in] hNodeEnum

A handle to the CLUSTER_ENUM_ITEM enumeration that contains the cluster node to retrieve.

[in] dwIndex

The index that identifies the next object to enumerate. This parameter should be zero for the first call to the ClusterEnumEx function and then be incremented for subsequent calls.

[in, out] pItem

A pointer that receives the returned cluster node.

[in, out] cbItem

On input, the size of the pItem parameter.

On output, either the required size in bytes of the buffer if the buffer is too small, or the number of bytes written into the buffer.

Return value

Return code Description
dwIndex is larger than the number of items in the enumeration.
The buffer is too small.
The buffer was filled successfully.


Minimum supported client None supported
Minimum supported server Windows Server 2008 R2 Datacenter, Windows Server 2008 R2 Enterprise
Target Platform Windows
Header clusapi.h
Library ClusAPI.lib
DLL ClusAPI.dll

See also


Node Management Functions