OnlineClusterResourceEx 函式 (clusapi.h)

發行項
02/26/2024

讓資源離線或失敗。

語法

DWORD OnlineClusterResourceEx(
  [in]           HRESOURCE hResource,
  [in]           DWORD     dwOnlineFlags,
  [in, optional] PBYTE     lpInBuffer,
  [in]           DWORD     cbInBufferSize
);

參數

[in] hResource

要上線之資源的句柄。

[in] dwOnlineFlags

旗標，指定要上線之資源的設定。

CLUSAPI_GROUP_ONLINE_IGNORE_RESOURCE_STATUS (0x00000001)

伺服器會忽略資源的鎖定模式。

CLUSAPI_RESOURCE_ONLINE_DO_NOT_UPDATE_PERSISTENT_STATE (0x00000002)

請勿更新資源的永續性狀態。

CLUSAPI_RESOURCE_ONLINE_NECESSARY_FOR_QUORUM (0x00000004)

資源必須上線，才能維護仲裁。

CLUSAPI_RESOURCE_ONLINE_BEST_POSSIBLE_NODE (0x00000008)

叢集服務是決定將在資源上線時裝載資源的節點。

Windows Server 2012 R2 和 Windows Server 2012：Windows Server 2016 之前不支援此值。

0

伺服器不會忽略資源的鎖定模式。

[in, optional] lpInBuffer

接收作業指令之輸入緩衝區的指標。 lpInBuffer 參數會格式化為屬性清單。

[in] cbInBufferSize

lpInBuffer 的大小，以位元組為單位。

傳回值

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

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

傳回碼	Description
ERROR_IO_PENDING	資源或其相依的其中一個資源已從其 Online 進入點函式傳回ERROR_IO_PENDING。

規格需求

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

另請參閱

故障轉移叢集資源管理功能

共用方式為