Método IBTTransmitter.TransmitMessage (COM)

 

Transmite un mensaje para un adaptador.

Sintaxis

  
        HRESULT IBTTransmitter::TransmitMessage(  
        IBaseMessage*  
        pMessage,  
BOOL*bDeleteMessage);  
  
Function TransmitMessage(  
pMessage  
 As IBaseMessage  
) As Boolean  
  

Parámetros

pMessage
[in] Referencia a un objeto o interfaz IBaseMessage que contiene el mensaje.

bDeleteMessage
[out,retval] Puntero a un valor booleano usado para devolver el mensaje de eliminación. true si el mensaje se ha transmitido; de lo contrario, false.

Valor devuelto

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.

true si el mensaje se ha transmitido; de lo contrario, false.

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.

Value Descripción
S_OK El método se completó correctamente.
FAILED HRESULT Indica que el mensaje no se ha podido transmitir correctamente. En este escenario, el motor de mensajería tratará el mensaje del siguiente modo:

- Si el mensaje tiene reintentos restantes, se volverá a enviar, el motor de mensajería usará el intervalo de reintento marcado en el mensaje.
- Si los reintentos se han agotado para este mensaje, el motor de mensajería intentará mover el mensaje al transporte de copia de seguridad.
- Si el motor de mensajería no puede mover el mensaje a su transporte de copia de seguridad, el motor de mensajería suspenderá el motor.

Comentarios

El motor de mensajería de BizTalk Server llama a este método.

Si el valor devuelto es true, el adaptador transmite el mensaje de forma sincrónica. Si el valor devuelto es false, el adaptador transmitirá el mensaje de forma asincrónica y volverá a llamar al motor de mensajería de BizTalk Server para notificarle el resultado de la transmisión.

Si el adaptador no puede transmitir el mensaje correctamente y no quiere que el adaptador controle la semántica del reintento, deberá lanzar una excepción. En este escenario, el motor de mensajería de BizTalk Server controlará la semántica del reintento. Generalmente, esto indica que el mensaje volverá a entregarse al adaptador hasta que lo transmita correctamente o se agoten el número de reintentos. Si éstos se agotan, el mensaje se moverá al transporte de reserva para su transmisión.

Requisitos

Plataformas: Windows

Consulte también

IBTTransmitter (interfaz) (COM)
Miembros de IBTTransmitter (COM)