SetClusterNetworkPriorityOrder

The SetClusterNetworkPriorityOrder function sets the priority order for the set of networks used for internal communication between cluster nodes.

DWORD WINAPI SetClusterNetworkPriorityOrder(
  HCLUSTER hCluster,   
  DWORD NetworkCount,   
  HNETWORK NetworkList[]  
);
 

Parameters

hCluster

[in] Handle to the cluster to be affected.

NetworkCount

[in] Number of items in the list specified by the NetworkList parameter.

NetworkList

[in] Prioritized array of handles to network objects. The first handle in the array has the highest priority. The list must contain only those networks that are used for internal communication between nodes in the cluster. All networks that can be used for node-to-node communication must appear in the list and there can be no duplicates.

Return Values

ERROR_SUCCESS

The operation was successful.

ERROR_NOT_ENOUGH_MEMORY

The operation was unsuccessful due to insufficient memory.

ERROR_INVALID_PARAMETER

There was a duplicate network in NetworkList.

If the operation was unsuccessful, SetClusterNetworkPriorityOrder can also return a Win32 error value.

Remarks

Internal communication is always carried on the highest priority network that is available between two nodes.

QuickInfo

  Version: Use Windows NT Server Enterprise Edition 4.0.
  Windows CE: Unsupported.
  Header: Declared in clusapi.h.