Metodo IBTTransmitter.TransmitMessage (COM)

 

Trasmette un messaggio per un adapter.

Sintassi

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

  
Function TransmitMessage(  
pMessage  
 As IBaseMessage  
) As Boolean  
  

Parametri

pMessage
[in] Riferimento a un oggetto/interfaccia IBaseMessage che contiene il messaggio.

bDeleteMessage
[out,retval] Puntatore a un valore booleano utilizzato per restituire il messaggio di eliminazione. true se il messaggio è stato trasmesso; in caso contrario, false.

Valore restituito

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.

true se il messaggio è stato trasmesso; in caso contrario, false.

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.
FAILED HRESULT	Indica che il messaggio non è stato trasmesso. In questo scenario il motore di messaggistica gestisce il messaggio nel modo seguente: - Se il messaggio ha nuovi tentativi rimanenti, verrà inviato di nuovo, il motore di messaggistica userà l'intervallo di ripetizione dei tentativi contrassegnato sul messaggio. - Se i tentativi sono stati esauriti per questo messaggio, il motore di messaggistica tenterà di spostare il messaggio nel trasporto di backup. - Se il motore di messaggistica non riesce a spostare il messaggio nel trasporto di backup, il motore di messaggistica sospende il motore.

Commenti

Il metodo viene chiamato dal motore di messaggistica di BizTalk Server.

Se il valore restituito è true, l'adapter ha trasmesso il messaggio in modo sincrono. Se il valore restituito è false, l'adapter trasmetterà il messaggio in modo asincrono e richiamerà il motore di messaggistica BizTalk Server per notificare il risultato della trasmissione.

Se l'adapter non riesce a trasmettere il messaggio e non si desidera che l'adapter gestisca la semantica dei tentativi, deve generare un'eccezione. In questo scenario il motore di messaggistica di BizTalk Server gestisce la semantica dei tentativi. In genere, ciò implica che il messaggio verrà recapitato nuovamente all'adapter fino a quando riuscirà a trasmettere il messaggio o si esauriranno tutti i tentativi. Se sono stati esauriti tutti i tentativi, il messaggio verrà spostato al trasporto di backup per essere trasmesso.

Requisiti

Piattaforme: Finestre

Vedere anche

Interfaccia IBTTransmitter (COM)
Membri di IBTTransmitter (COM)