다음을 통해 공유

파이프라인 구성 요소에서 오류 보고

  • 아티클

파이프라인 구성 요소는 다음 두 가지 방법으로 오류를 보고합니다.

  • .NET 기반 구성 요소의 경우 예외를 throw합니다.

  • COM 기반 구성 요소의 경우 ErrorInfo 개체를 설정하고 오류 HRESULT를 반환합니다.

.NET 파이프라인 구성 요소에서 오류 보고

.NET 기반 파이프라인 구성 요소에서 오류를 보고하려면 오류 설명을 보고하는 예외를 throw해야 합니다. 오류를 발생시키는 구성 요소의 이름을 보고하려면 Exception 개체의 Source 속성을 설정합니다.

메시징 엔진은 Exception 개체의 Message 및 Source 속성을 사용하여 오류를 보고합니다. 다음 메시지가 이벤트 로그에 기록됩니다.

"[receive|send] 파이프라인을 실행하는 동안 오류가 발생했습니다. <파이프라인 이름> 원본: <원본> [수신 위치|송신 포트:] <location|port name> Reason: <Message>."

COM 파이프라인 구성 요소에서 오류 보고

COM 기반 파이프라인 구성 요소에서는 오류를 보고하기 위해 다음과 같은 작업이 실행됩니다.

  1. 파이프라인 구성 요소는 SetErrorInfo 메서드를 호출하여 IErrorInfo 개체를 설정합니다.

  2. 파이프라인 구성 요소가 실패한 HRESULT를 메시징 엔진에 반환합니다.

    메시징 엔진은 IErrorInfo 개체의 GetSource 및 GetDescription 속성을 사용하여 오류를 보고합니다. 소스가 설정되어 있지 않으면 구성 요소의 이름이 사용됩니다. 설명이 설정되지 않았거나 전체 ErrorInfo 개체가 설정되지 않은 경우 반환된 HRESULT는 설명 대신 보고됩니다. 다음 메시지가 이벤트 로그에 기록됩니다.

    "[receive|send] 파이프라인을 실행하는 동안 오류가 발생했습니다. <파이프라인 이름> 원본: <GetSource> [수신 위치|송신 포트:] <location|port name> Reason: <GetDescription or HRESULT>."

참고 항목

사용자 지정 파이프라인 구성 요소 개발