ClusterNodeEnumEx function (clusapi.h)

  • Article

Retrieves the specified cluster node from a CLUSTER_ENUM_ITEM enumeration.

Syntax

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

Parameters

[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
ERROR_NO_MORE_ITEMS
 dwIndex is larger than the number of items in the enumeration.
ERROR_MORE_DATA
 The buffer is too small.
ERROR_SUCCESS
 The buffer was filled successfully.

Requirements

Requirement Value
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

CLUSTER_ENUM_ITEM

Node Management Functions