NCS_ListNodes

Lists the nodes available in a cluster.

Syntax

 #include <ncssdk.h> 
  
 NCS_RETURN NCS_ListNodes (
   NCS_HANDLE   Handle,
   UINT32       NodeArray[32],
   UINT32       IPArray[32]);
 

Parameters

Handle

(IN) Specifies the current NCS handle.

NodeArray[32]

(OUT) Specifies the node array is a 32 element UINT32 size buffer.

IPArray[32]

(OUT) Specifies the IP array is a 32 element UINT32 size buffer.

Return Values

Name

Description

NCS_SUCCESS

Success.

NCSS_FAILURE

See NDS Error Codes.

NCS_BAD_PARAMETER

Parameter not defined.

Remarks

NodeArray and IPArray must be 32 element UINT32 size buffers. NodeArray contains –1 for nodes not defined in the cluster (regardless of whether they are currently active in the cluster), or the 0-based node number of that node. IPArray contains 0 for all non-cluster nodes, and the 4-byte IP address for nodes defined in the cluster.