COM () 的 IBTTransmitterBatch.Done 方法

 

對配接器指示批次已完成且準備好要傳送。

語法

  
HRESULT IBTTransmitterBatch::Done(  
IBTDTCCommitConfirm*  
pDTCCommitConfirm  
);  
  

  
Sub Done(  
pDTCCommitConfirm  
 As IBTDTCCommitConfirm  
)  
  

備註

參數

pDTCCommitConfirm
[in]包含 DTC 認可確認的 IBTDTCCommitConfirm 物件/介面參考。 如果此配接器不是使用交易來傳輸，此參數將會是 NULL。 如果這個參數不是 NULL (這表示此配接器是使用 DTC 交易)，則需要回呼此配接器，將交易的結果通知 BizTalk Server 傳訊引擎。

pDTCCommitConfirm
包含 DTC 認可確認的IBTDTCCommitConfirm物件/介面。 如果此配接器不是使用交易來傳輸，此參數將會是 NULL。 如果這個參數不是 NULL (這表示此配接器是使用 DTC 交易)，則需要回呼此配接器，將交易的結果通知 BizTalk Server 傳訊引擎。

傳回值

這個方法會傳回 HRESULT，指出它是否已成功完成。 如需詳細資訊，請參閱「錯誤值」一節。

無。

錯誤值

這個方法會傳回 HRESULT，其中包含下表的一個值。

這個方法會將全域Err物件的Number屬性設定為下表中的其中一個值，以指出錯誤。

值	描述
S_OK	已成功完成命令。
FAILED HRESULT	如果 Done 方法失敗，傳訊引擎會以下列方式處理批次中的所有個別訊息： - 如果訊息剩餘重試，則會重新提交訊息，傳訊引擎將會使用訊息上戳記的重試間隔。 - 如果此訊息的重試已耗盡，傳訊引擎會嘗試將訊息移至備份傳輸。 - 如果訊息引擎無法將訊息移至其備份傳輸，傳訊引擎將會暫停訊息。

備註

當批次已滿或 BizTalk Server 傳訊引擎再也沒有訊息用於這個批次時，BizTalk Server 傳訊引擎會呼叫這個方法。 呼叫 Done 方法時，配接器將會傳輸批次中的所有訊息。

需求

平臺： 窗戶

另請參閱

COM (COM) 的 IBTTransmitterBatch 介面
COM) (IBTTransmitterBatch 成員