共用方式為

ClusterGroupSetControl 函式 (clusapi.h)

  • 發行項

起始影響群組集的作業。

執行的作業取決於傳遞至 dwControlCode 參數的控制程式代碼。

語法

DWORD ClusterGroupSetControl(
  [in]            HGROUPSET hGroupSet,
  [in, optional]  HNODE     hHostNode,
  [in]            DWORD     dwControlCode,
  [in, optional]  LPVOID    lpInBuffer,
  [in]            DWORD     cbInBufferSize,
  [out, optional] LPVOID    lpOutBuffer,
  [in]            DWORD     cbOutBufferSize,
  [out, optional] LPDWORD   lpBytesReturned
);

參數

[in] hGroupSet

要受影響的群組集句柄。

[in, optional] hHostNode

如果為非 NULL，請處理節點，以執行控件程式代碼所代表的作業。 如果 為 NULL，則擁有群組集的 節點 會執行作業。 指定 hHostNode 是選擇性的。

[in] dwControlCode

集合控制項程式代碼，指定要執行的作業。 如需與控件程式代碼相關聯的語法，請參閱
控制程式代碼架構 和下列主題。

[in, optional] lpInBuffer

輸入緩衝區的指標，其中包含作業所需的資訊，如果不需要任何資訊， 則為 NULL 。

[in] cbInBufferSize

輸入緩衝區的位元組) 配置大小 (。

[out, optional] lpOutBuffer

輸出緩衝區的指標，以接收作業所產生的數據，如果沒有傳回任何數據，則為 NULL 。

[in] cbOutBufferSize

輸出緩衝區的位元組) 配置大小 (。

[out, optional] lpBytesReturned

傳回實際大小 (以位元組為單位，) 作業所產生的數據。 如果不需要這項資訊，請針對 lpBytesReturned 傳遞 NULL。

傳回值

函式會傳回下列其中一個值。

傳回碼 Description
ERROR_SUCCESS
 作業成功。 如果作業需要輸出緩衝區，如果輸入) 上不是 NULL，則 lpBytesReturned (會指向緩衝區中傳回之數據的實際大小。
ERROR_MORE_DATA
 lpOutBuffer 所指向的輸出緩衝區不夠大，無法保存作業所產生的數據。 如果輸入) 上不是 NULL，則 lpBytesReturned 參數 (指向輸出緩衝區所需的大小。 只有需要輸出緩衝區傳回 ERROR_MORE_DATA的作業。 如果 lpOutBuffer 參數為 NULL ，且 nOutBufferSize 參數為零，則可能會傳回 ERROR_SUCCESS ，而不是 ERROR_MORE_DATA。
系統錯誤碼
 作業未成功。 如果作業需要輸出緩衝區，則輸入) 上沒有 NULL 時，lpBytesReturned 所指定的值 (不可靠。

規格需求

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