IBTTransportProxy.GetBatch 方法 (COM)

  • 發行項

 

取得新的傳輸 Proxy 批次。

語法

  
        HRESULT IBTTransportProxy::GetBatch(  
        IBTBatchCallBack*  
        pCallBack,  
VARIANTvCallbackCookie,  
IBTTransportBatch**ppBatch);  

  
        Function GetBatch(  
        pCallBack  
         As IBTBatchCallBack,  
vCallbackCookie As Variant) As IBTTransportBatch

備註

參數

pCallBack
[in] IBTBatchCallBack 物件/介面的參考。 在批次上呼叫 COM () 方法的 IBTTransportBatch.Done 方法 之後，就會對這個介面進行回呼，並處理批次。 IBTTransportBatch.Done 方法 (COM) 方法是低成本的方法呼叫，因為它會將批次張貼至執行緒集區。 一旦執行緒集區完成批次的處理，便會進行回呼。 此參數不能設定為 NULL。

pCallBack
IBTBatchCallBack 物件/介面。 在批次上呼叫 COM () 方法的 IBTTransportBatch.Done 方法 之後，就會對這個介面進行回呼，並處理批次。 IBTTransportBatch.Done 方法 (COM) 方法是低成本的方法呼叫，因為它會將批次張貼至執行緒集區。 一旦執行緒集區完成批次的處理，便會進行回呼。 此參數可以設定為 NULL。

vCallbackCookie
[in] 含有回呼 Cookie 的 Variant。 在 IBTBatchCallBack 介面 上呼叫回呼 (COM) 介面時，Cookie 會傳回配接器。 這個參數可以設定為 VT_EMPTY 型別的 Variant。

vCallbackCookie
包含回呼 Cookie 的Variant。 在 IBTBatchCallBack 介面 上呼叫回呼 (COM) 介面時，Cookie 會傳回配接器。 這個參數可以設定為 VT_EMPTY 型別的 Variant。

ppBatch
[out，retval]要保存所傳回 IBTTransportBatch 物件/介面之參考的指標，其中包含新的批次。

傳回值

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

如果此方法順利完成，它會傳回包含新批次 的 IBTTransportBatch 介面 (COM) 。

錯誤值

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

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

值 描述
S_OK 已成功完成命令。
BTS_E_MESSAGING_SHUTTING_DOWN 傳訊引擎正在關閉。
E_INVALIDARG 偵測到無效的參數。

備註

配接器可以使用回呼指標、Cookie 參數或參數的組合，使特定的批次與配接器的內部資料結構相互關聯。 這個方法的設計是要盡量具有彈性，因此不會限制配接器的內部程式設計模型。

批次在 MessageBox 是不可部分完成的。 如果批次失敗，便不會有工作在 MessageBox 獲得認可。

需求

平臺： 窗戶

另請參閱

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