ClusterRegCloseBatchEx 函式 (clusapi.h)

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

語法

LONG ClusterRegCloseBatchEx(
  [in]            HREGBATCH hRegBatch,
  [in]            DWORD     flags,
  [out, optional] INT       *failedCommandNumber
);

參數

[in] hRegBatch

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

[in] flags

[out, optional] failedCommandNumber

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

傳回值

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

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

備註

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

規格需求

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

另請參閱

叢集登錄存取函式

ClusterRegCloseBatch