ClusterRegCloseBatch 函式 (clusapi.h)

執行或忽略 ClusterRegCreateBatch 函式所建立的批次。

語法

LONG ClusterRegCloseBatch(
  [in]            HREGBATCH hRegBatch,
  [in]            BOOL      bCommit,
  [out, optional] INT       *failedCommandNumber
);

參數

[in] hRegBatch

ClusterRegCreateBatch 所開啟之叢集登錄機碼的句柄。 完成 ClusterRegCloseBatch 之後，此句柄就不再有效，而且會釋放與其相關聯的記憶體。

[in] bCommit

如果此參數採用的值為 true，則會將批次傳送給叢集伺服器執行。

[out, optional] failedCommandNumber

如果批次的執行不成功，則會以 failedCommandNumber 自變數的形式傳回失敗的命令數目。 批次中的第一個命令具有數位 0、第二個命令具有數位 1 等等。

傳回值

函式會傳回下列其中一個 系統錯誤碼。

傳回碼/值	Description
ERROR_SUCCESS 0	作業成功。
ERROR_INVALID_HANDLE 6	句柄無效。 如果 hRegBatch 參數為 NULL，則會傳回此值。

備註

如果在執行任何命令之前發生失敗， failedCommandNumber 參數會設定為 –1。

PCLUSTER_REG_CLOSE_BATCH類型會定義此函式的指標。

規格需求

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

另請參閱

叢集登錄存取函式

ClusterRegBatchAddCommand

ClusterRegCloseBatchEx

ClusterRegCreateBatch