onlineClusterGroup 函式 (clusapi.h)

讓群組上線。 PCLUSAPI_ONLINE_CLUSTER_GROUP類型會定義此函式的指標。

語法

DWORD OnlineClusterGroup(
  [in]           HGROUP hGroup,
  [in, optional] HNODE  hDestinationNode
);

[in] hGroup

要上線之群組的句柄。

[in, optional] hDestinationNode

處理 hGroup 所識別群組應該上線或 NULL 的節點。

如果作業成功，函式會 傳回ERROR_SUCCESS。

如果作業失敗，函式會傳回系統錯誤碼。以下是可能的錯誤碼。

傳回碼	Description
ERROR_HOST_NODE_NOT_AVAILABLE	無法使用適當的主機節點。
ERROR_IO_PENDING	作業正在進行中。

如果群組無法在 hDestinationNode 參數所識別的節點上上線， OnlineClusterGroup 函式會失敗。

如果 hDestinationNode 參數設定為 NULL，OnlineClusterGroup 會在目前的節點上讓群組上線。

請勿從資源 DLL 呼叫 OnlineClusterGroup 。如需詳細資訊，請參閱在資源 DLL 中避免的函數調用。

請勿將 LPC 和 RPC 句柄傳遞至相同的函數調用。否則，呼叫將會引發 RPC 例外狀況，而且可能會有額外的破壞性影響。如需如何建立 LPC 和 RPC 句柄的資訊，請參閱使用物件句柄和 OpenCluster。

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
目標平台	Windows
標頭	clusapi.h
程式庫	ClusAPI.lib
Dll	ClusAPI.dll