(COM) 的 IBTTransmitterBatch.TransmitMessage 方法

  • 發行項

 

新增訊息至準備傳輸的配接器批次。

語法

  
        HRESULT IBTTransmitterBatch::TransmitMessage(  
        IBaseMessage*  
        pMessage,  
BOOL*bDeleteMsgOnDone);  

  
Function TransmitMessage(  
pMessage  
 As IBaseMessage  
) As Boolean

備註

參數

pMessage
[in]包含訊息的 IBaseMessage 物件/介面參考。

pMessage
包含要傳輸之訊息的IBaseMessage物件/介面。

bDeleteMsgOnDone
[out，retval]布林值的指標，用來傳回已刪除訊息的狀態。 如果訊息已傳輸，則為true;否則為false。

傳回值

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

如果訊息已傳輸，則為true;否則為false。

錯誤值

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

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

值 描述
S_OK 已成功完成命令。
FAILED HRESULT 如果 TransmitMessage 方法失敗，傳訊引擎會繼續將訊息推送至批次，直到批次已滿或沒有目的地為批次的訊息為止。 傳訊引擎接著會在批次上呼叫 Clear 方法，然後以下列方式處理訊息：

- 如果訊息剩餘重試，則會重新提交訊息，傳訊引擎將會使用訊息上戳記的重試間隔。
- 如果此訊息的重試已用盡，傳訊引擎會嘗試將訊息移至備份傳輸。
- 如果傳訊引擎無法將訊息移至其備份傳輸，傳訊引擎將會暫停訊息。

備註

這個方法是由 BizTalk Server 傳訊引擎所呼叫。

如果傳回值為 true，配接器會同步傳送批次上的訊息。 如果傳回值為 false，配接器會以非同步方式在批次上傳送訊息。 如果傳回 false ，則配接器會負責在傳送訊息之後更新資料庫中的訊息資訊。 配接器可以重新提交訊息、刪除訊息、擱置訊息，或者將它移至備份傳輸。

當呼叫此訊息時，配接器實際上不會傳輸訊息，呼叫 Done 方法時就會開始傳輸。

需求

平臺： 窗戶

另請參閱

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