방법: HRESULT 및 예외 매핑

아티클
04/08/2023

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의 비교 가능한 예외 클래스 간의 일반적인 매핑을 제공합니다. 명시적 매핑이 없는 HRESULT 값은 COMException에 매핑됩니다. 전체 최신 매핑은 dotnet/runtime 리포지토리에서 찾을 수 있습니다.

HRESULT	.NET 예외
`COR_E_APPLICATION`	`ApplicationException`
`COR_E_ARGUMENT` 또는 `E_INVALIDARG`	`ArgumentException`
`COR_E_ARGUMENTOUTOFRANGE`	`ArgumentOutOfRangeException`
`COR_E_ARITHMETIC or ERROR_ARITHMETIC_OVERFLOW`	`ArithmeticException`
`COR_E_ARRAYTYPEMISMATCH`	`ArrayTypeMismatchException`
`COR_E_BADIMAGEFORMAT or ERROR_BAD_FORMAT`	`BadImageFormatException`
`COR_E_DIRECTORYNOTFOUND or ERROR_PATH_NOT_FOUND`	`DirectoryNotFoundException`
`COR_E_DIVIDEBYZERO`	`DivideByZeroException`
`COR_E_DUPLICATEWAITOBJECT`	`DuplicateWaitObjectException`
`COR_E_ENDOFSTREAM`	`EndOfStreamException`
`COR_E_ENTRYPOINTNOTFOUND`	`EntryPointNotFoundException`
`COR_E_EXCEPTION`	`Exception`
`COR_E_EXECUTIONENGINE`	`ExecutionEngineException`
`COR_E_FIELDACCESS`	`FieldAccessException`
`COR_E_FILENOTFOUND or ERROR_FILE_NOT_FOUND`	`FileNotFoundException`
`COR_E_FORMAT`	`FormatException`
`COR_E_INDEXOUTOFRANGE`	`IndexOutOfRangeException`
`COR_E_INVALIDCAST or E_NOINTERFACE`	`InvalidCastException`
`COR_E_INVALIDFILTERCRITERIA`	`InvalidFilterCriteriaException`
`COR_E_INVALIDOPERATION`	`InvalidOperationException`
`COR_E_IO`	`IOException`
`COR_E_MEMBERACCESS`	`AccessException`
`COR_E_METHODACCESS`	`MethodAccessException`
`COR_E_MISSINGFIELD`	`MissingFieldException`
`COR_E_MISSINGMANIFESTRESOURCE`	`MissingManifestResourceException`
`COR_E_MISSINGMEMBER`	`MissingMemberException`
`COR_E_MISSINGMETHOD`	`MissingMethodException`
`COR_E_NOTFINITENUMBER`	`NotFiniteNumberException`
`E_NOTIMPL`	`NotImplementedException`
`COR_E_NOTSUPPORTED`	`NotSupportedException`
`COR_E_NULLREFERENCE orE_POINTER`	`NullReferenceException`
`COR_E_OUTOFMEMORY or` `E_OUTOFMEMORY`	`OutOfMemoryException`
`COR_E_OVERFLOW`	`OverflowException`
`COR_E_PATHTOOLONG or ERROR_FILENAME_EXCED_RANGE`	`PathTooLongException`
`COR_E_RANK`	`RankException`
`COR_E_REFLECTIONTYPELOAD`	`ReflectionTypeLoadException`
`COR_E_SECURITY`	`SecurityException`
`COR_E_SERIALIZATION`	`SerializationException`
`COR_E_STACKOVERFLOW orERROR_STACK_OVERFLOW`	`StackOverflowException`
`COR_E_SYNCHRONIZATIONLOCK`	`SynchronizationLockException`
`COR_E_SYSTEM`	`SystemException`
`COR_E_TARGET`	`TargetException`
`COR_E_TARGETINVOCATION`	`TargetInvocationException`
`COR_E_TARGETPARAMCOUNT`	`TargetParameterCountException`
`COR_E_THREADINTERRUPTED`	`ThreadInterruptedException`
`COR_E_THREADSTATE`	`ThreadStateException`
`COR_E_TYPELOAD`	`TypeLoadException`
`COR_E_TYPEINITIALIZATION`	`TypeInitializationException`
`COR_E_VERIFICATION`	`VerificationException`

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

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

예외 필드	COM의 정보 소스
`ErrorCode`	호출에서 반환된 HRESULT.
`HelpLink`	`IErrorInfo->HelpContext`가 0이 아닌 경우 문자열은 `IErrorInfo->GetHelpFile`과 "#" 및 `IErrorInfo->GetHelpContext`를 연결하여 구성됩니다. 그러지 않으면 문자열이 `IErrorInfo->GetHelpFile`에서 반환됩니다.
`InnerException`	항상 Null 참조(Visual Basic의 경우 `Nothing`)입니다.
`Message`	`IErrorInfo->GetDescription`에서 반환된 문자열.
`Source`	`IErrorInfo->GetSource`에서 반환된 문자열.
`StackTrace`	스택 추적입니다.
`TargetSite`	실패한 HRESULT를 반환한 메서드의 이름.

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

다음을 통해 공유

방법: HRESULT 및 예외 매핑

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

참고 항목

추가 리소스