SetClusterNetworkPriorityOrder 函数 (clusapi.h)

[此函数可用于“要求”部分中指定的操作系统。 Windows Server 2008 中删除了对此方法的支持，此函数不执行任何操作并返回 ERROR_CALL_NOT_IMPLEMENTED。]

设置用于群集节点之间内部通信的网络集的优先级顺序。 PCLUSAPI_SET_CLUSTER_NETWORK_PRIORITY_ORDER类型定义指向此函数的指针。

语法

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

[in] hCluster

要受影响的群集的句柄。

[in] NetworkCount

由 NetworkList 参数指定的列表中的项数。

[in] NetworkList

按优先级排列的网络对象的句柄数组。数组中的第一个句柄具有最高优先级。该列表必须仅包含用于群集中节点之间的内部通信的网络，并且不能有重复项。

如果操作成功，函数将返回 ERROR_SUCCESS ( 0) 。

如果操作失败，函数将返回系统错误代码。下面是可能的错误代码。

返回代码/值	说明
ERROR_INVALID_PARAMETER 87 (0x57)	NetworkList 中有重复的网络。

不要将 LPC 和 RPC 句柄传递给同一函数调用。否则，调用将引发 RPC 异常，并可能会产生其他破坏性影响。有关如何创建 LPC 和 RPC 句柄的信息，请参阅使用对象句柄和 OpenCluster。

要求	值
最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2003 企业版、Windows Server 2003 Datacenter
目标平台	Windows
标头	clusapi.h
Library	ClusAPI.lib
DLL	ClusAPI.dll