방법: HRESULT 및 예외 매핑

업데이트: 2007년 11월

COM 메서드는 HRESULT를 반환하여 오류를 보고하고 .NET 메서드는 예외를 throw하여 보고합니다. 런타임은 이 둘 사이의 전환을 처리합니다. .NET Framework의 각 예외 클래스는 HRESULT에 매핑됩니다.

사용자 정의 예외 클래스는 적절한 HRESULT를 지정할 수 있습니다. 이 예외 클래스는 예외 개체에 HResult 필드를 설정하여 예외를 생성할 때 반환되는 HRESULT를 동적으로 변경할 수 있습니다. 예외에 대한 추가 정보는 관리되지 않는 프로세스에서 .NET 개체에 구현되는 IErrorInfo 인터페이스를 통해 클라이언트에 제공됩니다.

System.Exception을 확장하는 클래스를 만드는 경우 생성하는 동안 HRESULT 필드를 설정해야 합니다. 그렇지 않으면 기본 클래스에서 HRESULT 값을 할당합니다. 예외 생성자에서 값을 제공하여 새 예외 클래스를 기존의 HRESULT에 매핑할 수 있습니다.

런타임은 스레드에 IErrorInfo가 있는 경우 HRESULT를 무시하기도 합니다. 이러한 동작은 HRESULT와 IErrorInfo가 동일한 오류를 나타내지 않는 경우에 발생할 수 있습니다.

새 예외 클래스를 만들어 HRESULT에 매핑하려면

• 다음 코드를 사용하여 NoAccessException이라는 새 예외 클래스를 만든 다음 HRESULT E_ACCESSDENIED에 매핑합니다.

  Class NoAccessException : public ApplicationException
  {
      NoAccessException () {
      HResult = E_ACCESSDENIED; 
  }
  }
  CMyClass::MethodThatThrows
  {
  throw new NoAccessException();
  }
  

관리 코드와 비관리 코드를 동시에 사용하는 프로그램(모든 프로그래밍 언어 사용 가능)을 발견할 수 있습니다. 예를 들어 다음 코드 예제에서 사용자 지정 마샬러는 Marshal.ThrowExceptionForHR(int HResult) 메서드를 사용하여 특정 HRESULT 값으로 예외를 throw합니다. 이 메서드는 HRESULT를 찾아서 적절한 예외 형식을 생성합니다. 예를 들어 다음 코드의 HRESULT는 ArgumentException을 생성합니다.

CMyClass::MethodThatThrows
{
    Marshal.ThrowExceptionForHR(COR_E_ARGUMENT);
}

다음 표에서는 각 HRESULT에서 .NET Framework의 해당 예외 클래스로의 전체 매핑을 제공합니다.

확장된 오류 정보를 검색하려면 관리되는 클라이언트가 생성된 예외 개체의 필드를 검토해야 합니다. 예외 개체에서 오류에 관한 유용한 정보를 제공하기 위해 COM 개체는 IErrorInfo 인터페이스를 구현해야 합니다. 런타임은 IErrorInfo에서 제공하는 정보를 사용하여 예외 개체를 초기화합니다.

COM 개체에서 IErrorInfo를 지원하지 않는 경우 런타임은 기본값을 사용하여 예외 개체를 초기화합니다. 다음 표에서는 예외 개체와 관련된 각 필드를 나열하고 COM 개체가 IErrorInfo를 지원하는 경우 기본 정보의 소스를 식별합니다.

런타임은 스레드에 IErrorInfo가 있는 경우 HRESULT를 무시하기도 합니다. 이러한 동작은 HRESULT와 IErrorInfo가 동일한 오류를 나타내지 않는 경우에 발생할 수 있습니다.

Message, Source 및 StackTrace와 같은 예외 필드는 StackOverflowException에 사용할 수 없습니다.

참고 항목

기타 리소스

고급 수준의 COM 상호 운용성

예외 처리 및 Throw