내보내기(0) 인쇄
모두 확장
이 문서는 기계로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오. 추가 정보
번역
원본

방법: HRESULT 및 예외 매핑

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

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

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

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

새 예외 클래스를 만들어 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의 해당 예외 클래스로의 전체 매핑을 제공합니다.

HRESULT

.NET 예외

MSEE_E_APPDOMAINUNLOADED

AppDomainUnloadedException

COR_E_APPLICATION

ApplicationException

COR_E_ARGUMENT 또는 E_INVALIDARG

ArgumentException

COR_E_ARGUMENTOUTOFRANGE

ArgumentOutOfRangeException

COR_E_ARITHMETIC 또는 ERROR_ARITHMETIC_OVERFLOW

ArithmeticException

COR_E_ARRAYTYPEMISMATCH

ArrayTypeMismatchException

COR_E_BADIMAGEFORMAT 또는 ERROR_BAD_FORMAT

BadImageFormatException

COR_E_COMEMULATE_ERROR

COMEmulateException

COR_E_CONTEXTMARSHAL

ContextMarshalException

COR_E_CORE

CoreException

NTE_FAIL

CryptographicException

COR_E_DIRECTORYNOTFOUND 또는 ERROR_PATH_NOT_FOUND

DirectoryNotFoundException

COR_E_DIVIDEBYZERO

DivideByZeroException

COR_E_DUPLICATEWAITOBJECT

DuplicateWaitObjectException

COR_E_ENDOFSTREAM

EndOfStreamException

COR_E_TYPELOAD

EntryPointNotFoundException

COR_E_EXCEPTION

Exception

COR_E_EXECUTIONENGINE

ExecutionEngineException

COR_E_FIELDACCESS

FieldAccessException

COR_E_FILENOTFOUND 또는 ERROR_FILE_NOT_FOUND

FileNotFoundException

COR_E_FORMAT

FormatException

COR_E_INDEXOUTOFRANGE

IndexOutOfRangeException

COR_E_INVALIDCAST 또는 E_NOINTERFACE

InvalidCastException

COR_E_INVALIDCOMOBJECT

InvalidComObjectException

COR_E_INVALIDFILTERCRITERIA

InvalidFilterCriteriaException

COR_E_INVALIDOLEVARIANTTYPE

InvalidOleVariantTypeException

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_MULTICASTNOTSUPPORTED

MulticastNotSupportedException

COR_E_NOTFINITENUMBER

NotFiniteNumberException

E_NOTIMPL

NotImplementedException

COR_E_NOTSUPPORTED

NotSupportedException

COR_E_NULLREFERENCE 또는 E_POINTER

NullReferenceException

COR_E_OUTOFMEMORY 또는

E_OUTOFMEMORY

OutOfMemoryException

COR_E_OVERFLOW

OverflowException

COR_E_PATHTOOLONG 또는 ERROR_FILENAME_EXCED_RANGE

PathTooLongException

COR_E_RANK

RankException

COR_E_REFLECTIONTYPELOAD

ReflectionTypeLoadException

COR_E_REMOTING

RemotingException

COR_E_SAFEARRAYTYPEMISMATCH

SafeArrayTypeMismatchException

COR_E_SECURITY

SecurityException

COR_E_SERIALIZATION

SerializationException

COR_E_STACKOVERFLOW 또는 ERROR_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_THREADABORTED

ThreadAbortException

COR_E_THREADINTERRUPTED

ThreadInterruptedException

COR_E_THREADSTATE

ThreadStateException

COR_E_THREADSTOP

ThreadStopException

COR_E_TYPELOAD

TypeLoadException

COR_E_TYPEINITIALIZATION

TypeInitializationException

COR_E_VERIFICATION

VerificationException

COR_E_WEAKREFERENCE

WeakReferenceException

COR_E_VTABLECALLSNOTSUPPORTED

VTableCallsNotSupportedException

다른 모든 HRESULT

COMException

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

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

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

예외 필드

COM의 정보 소스

ErrorCode

호출에서 반환된 HRESULT

HelpLink

IErrorInfo->HelpContext가 0이 아닌 경우 IErrorInfo->GetHelpFile, "#", IErrorInfo->GetHelpContext를 연결하여 문자열을 구성합니다. 그렇지 않은 경우에는 IErrorInfo->GetHelpFile에서 문자열이 반환됩니다.

InnerException

항상 null 참조(Visual Basic에서는 Nothing)

메시지

IErrorInfo->GetDescription에서 반환된 문자열

소스

IErrorInfo->GetSource에서 반환된 문자열

StackTrace

스택 추적

TargetSite

실패한 HRESULT를 반환한 메서드의 이름

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

커뮤니티 추가 항목

추가
표시:
© 2014 Microsoft