Metodo IBTTransportProxy.GetBatch (COM)

 

Ottiene un nuovo batch proxy di trasporto.

Sintassi

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

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

Osservazioni

Parameters

pCallBack
[in] Riferimento a un oggetto/interfaccia IBTBatchCallBack . Il callback verrà eseguito a questa interfaccia dopo che il metodo IBTTransportBatch.Done (COM) è stato chiamato nel batch e il batch è stato elaborato. Il metodo IBTTransportBatch.Done (COM) è una chiamata al metodo a basso costo perché inserisce il batch nel pool di thread. La richiamata verrà eseguita dopo che il pool di thread avrà completato l'elaborazione del batch. Questo parametro non può essere impostato su NULL.

pCallBack
Oggetto/interfaccia IBTBatchCallBack. Il callback verrà eseguito a questa interfaccia dopo che il metodo IBTTransportBatch.Done (COM) è stato chiamato nel batch e il batch è stato elaborato. Il metodo IBTTransportBatch.Done (COM) è una chiamata al metodo a basso costo perché inserisce il batch nel pool di thread. La richiamata verrà eseguita dopo che il pool di thread avrà completato l'elaborazione del batch. Questo parametro può essere impostato su NULL.

vCallbackCookie
[in] Variante contenente il cookie di richiamata. Il cookie verrà passato all'adattatore quando il callback viene chiamato sull'interfaccia COM (IBTBatchCallBack Interface). Questo parametro può essere impostato su una variante di tipo VT_EMPTY.

vCallbackCookie
Variant contenente il cookie di callback. Il cookie verrà passato all'adattatore quando il callback viene chiamato sull'interfaccia COM (IBTBatchCallBack Interface). Questo parametro può essere impostato su una variante di tipo VT_EMPTY.

ppBatch
[out,retval] Puntatore per contenere il riferimento all'oggetto /interfaccia IBTTransportBatch restituito, che conterrà il nuovo batch.

Valori restituiti

Questo metodo restituisce un HRESULT che indica se il metodo viene completato in modo corretto. Per ulteriori dettagli, vedere la sezione relativa ai valori di errore.

Se questo metodo viene completato correttamente, restituisce un'interfaccia COM (IBTTransportBatch Interface) contenente il nuovo batch.

Valori di errore

Questo metodo restituisce un HRESULT contenente uno dei valori riportati nella tabella seguente.

Questo metodo indica gli errori impostando la proprietà Number dell'oggetto Err globale su uno dei valori della tabella seguente.

Valore	Descrizione
S_OK	Metodo completato correttamente.
BTS_E_MESSAGING_SHUTTING_DOWN	Il motore di messaggistica è in fase di arresto.
E_INVALIDARG	È stato rilevato un parametro non valido.

Osservazioni:

L'adapter può utilizzare il puntatore di richiamata, un parametro cookie o una combinazione di parametri per correlare un particolare batch alle strutture dati interne dell'adapter. Questo metodo è progettato per essere quanto più flessibile è possibile e per non limitare quindi il modello di programmazione interno dell'adapter.

Il batch è atomico in relazione a MessageBox. Se un batch ha esito negativo, di nessun elemento del lavoro verrà eseguito il commit nel database MessageBox.

Requisiti

Piattaforme: Finestre

Vedere anche

Interfaccia IBTTransportProxy (COM)
Membri di IBTTransportProxy (COM)