IBTTransmitter.TransmitMessage 메서드(COM)

아티클
07/21/2023

어댑터에 대한 메시지를 전송합니다.

구문

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

  
Function TransmitMessage(  
pMessage  
 As IBaseMessage  
) As Boolean

매개 변수

pMessage
[in] 메시지를 포함하는 IBaseMessage 개체/인터페이스에 대한 참조입니다.

bDeleteMessage
[out,retval] 삭제 메시지를 반환하는 데 사용되는 부울에 대한 포인터입니다. 메시지가 전송된 경우 true입니다. 그렇지 않으면 false입니다.

반환 값

이 메서드는 메서드가 성공적으로 완료되었는지 여부를 나타내는 HRESULT를 반환합니다. 자세한 내용은 오류 값 섹션을 참조하십시오.

메시지가 전송된 경우 true입니다. 그렇지 않으면 false입니다.

오류 값

이 메서드는 다음 표에 있는 값 중 하나를 포함하는 HRESULT를 반환합니다.

이 메서드는 전역 Err 개체의 Number 속성을 다음 표의 값 중 하나로 설정하여 오류를 나타냅니다.

값	설명
S_OK	메서드가 완료되었습니다.
FAILED HRESULT	메시지를 성공적으로 전송할 수 없음을 나타냅니다. 이 시나리오에서 메시징 엔진은 다음과 같은 방식으로 해당 메시지를 처리합니다. - 메시지에 재시도가 남아 있는 경우 다시 전송됩니다. 메시징 엔진은 메시지에 스탬프가 찍인 재시도 간격을 사용합니다. - 이 메시지에 대해 재시도가 소진된 경우 메시징 엔진은 메시지를 백업 전송으로 이동하려고 시도합니다. - 메시징 엔진이 메시지를 백업 전송으로 이동할 수 없는 경우 메시징 엔진은 엔진을 일시 중단합니다.

S_OK

메서드가 완료되었습니다.

FAILED HRESULT

메시지를 성공적으로 전송할 수 없음을 나타냅니다. 이 시나리오에서 메시징 엔진은 다음과 같은 방식으로 해당 메시지를 처리합니다.

- 메시지에 재시도가 남아 있는 경우 다시 전송됩니다. 메시징 엔진은 메시지에 스탬프가 찍인 재시도 간격을 사용합니다.
- 이 메시지에 대해 재시도가 소진된 경우 메시징 엔진은 메시지를 백업 전송으로 이동하려고 시도합니다.
- 메시징 엔진이 메시지를 백업 전송으로 이동할 수 없는 경우 메시징 엔진은 엔진을 일시 중단합니다.

설명

이 메서드는 BizTalk Server 메시징 엔진에서 호출합니다.

반환 값이 true이면 어댑터가 메시지를 동기적으로 전송합니다. 반환 값이 false이면 어댑터는 메시지를 비동기적으로 전송하고 BizTalk Server 메시징 엔진을 다시 호출하여 전송 결과를 알립니다.

어댑터가 메시지를 성공적으로 전송하지 못한 경우 어댑터가 재시도 의미를 처리하지 않게 하려면 예외가 throw되어야 합니다. 이 시나리오에서 BizTalk Server 메시징 엔진은 재시도 의미를 처리합니다. 즉, 메시지를 성공적으로 전송하거나 재시도 횟수를 모두 사용할 때까지 메시지를 어댑터에 다시 배달합니다. 재시도 횟수를 모두 사용한 경우 메시지는 전송을 위해 백업 전송으로 이동됩니다.

요구 사항

플랫폼: Windows

참고 항목

IBTTransmitter 인터페이스(COM)
IBTTransmitter 멤버(COM)