COM (IBTTransportProxy.GetBatch 方法)

 

取得新的傳輸 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 方法 (COM) 方法之後,就會對此介面發出回呼。 IBTTransportBatch.Done 方法 (COM) 方法是低成本的方法呼叫,因為它會將批次張貼到執行緒集區。 一旦執行緒集區完成批次的處理,便會進行回呼。 此參數不能設定為 NULL。

pCallBack
IBTBatchCallBack 物件/介面。 在批次上呼叫 COM) 方法並處理批次之後 ,IBTTransportBatch.Done 方法 (COM) 方法之後,就會對此介面發出回呼。 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 成員