Método IBTTransportProxy.GetBatch (COM)

 

Obtiene un lote de proxy de transporte nuevo.

Sintaxis

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

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

Comentarios

Parámetros

pCallBack
[in] Referencia a un objeto o interfaz IBTBatchCallBack . La devolución de llamada se realizará en esta interfaz después de que se haya llamado al método IBTTransportBatch.Done (COM) en el lote y se haya procesado el lote. El método IBTTransportBatch.Done (COM) es una llamada de método de bajo costo, ya que envía el lote al grupo de subprocesos. La devolución de llamada se realizará cuando el grupo de subprocesos haya finalizado el procesamiento del lote. Este parámetro no se puede establecer como NULL.

pCallBack
Objeto/interfaz IBTBatchCallBack . La devolución de llamada se realizará en esta interfaz después de que se haya llamado al método IBTTransportBatch.Done (COM) en el lote y se haya procesado el lote. El método IBTTransportBatch.Done (COM) es una llamada de método de bajo costo, ya que envía el lote al grupo de subprocesos. La devolución de llamada se realizará cuando el grupo de subprocesos haya finalizado el procesamiento del lote. Este parámetro se puede establecer como NULL.

vCallbackCookie
[in] Variante que contiene la cookie de devolución de llamada. La cookie se devolverá al adaptador cuando se llame a la devolución de llamada en la interfaz IBTBatchCallBack (COM). Este parámetro se puede establecer en una variante del tipo VT_EMPTY.

vCallbackCookie
Variante que contiene la cookie de devolución de llamada. La cookie se devolverá al adaptador cuando se llame a la devolución de llamada en la interfaz IBTBatchCallBack (COM). Este parámetro se puede establecer en una variante del tipo VT_EMPTY.

ppBatch
[out,retval] Puntero para contener la referencia al objeto o interfaz IBTTransportBatch devuelto, que contendrá el nuevo lote.

Valores devueltos

Este método devuelve un valor HRESULT que indica si se ha completado correctamente. Consulte la sección Valores de error para obtener información más detallada.

Si este método se completa correctamente, devuelve una interfaz IBTTransportBatch (COM) que contiene el nuevo lote.

Valores de error

Este método devuelve un HRESULT que contiene uno de los valores de la siguiente tabla.

Este método indica errores estableciendo la propiedad Number del objeto Err global en uno de los valores de la tabla siguiente.

Valor	Descripción
S_OK	El método se completó correctamente.
BTS_E_MESSAGING_SHUTTING_DOWN	El motor de mensajería se está cerrando.
E_INVALIDARG	Se detectó un parámetro no válido.

Comentarios:

El adaptador puede usar el puntero de devolución de llamada, un parámetro de cookie o una combinación de los parámetros para correlacionar un lote concreto en las estructuras internas de datos para el adaptador. Este método pretende ser todo lo flexible como sea posible para no tener que restringir el modelo de programación interna del adaptador.

El lote es atómico con respecto al cuadro de mensajes. Si se produce un error en el lote, no se confirmará nada del trabajo en el cuadro de mensajes.

Requisitos

Plataformas: Windows

Consulte también

Interfaz IBTTransportProxy (COM)
Miembros de IBTTransportProxy (COM)