Como: Map HRESULTs and Exceptions

Métodos COM relatam erros, retornando HRESULTs; .NET métodos relatá-los Lançando exceções. O runtime lida com a transição entre os dois. Cada classe de exceção na.NET Framework mapeia para um HRESULT.

Classes de exceção definido pelo usuário podem especificar que HRESULT for mais apropriado. Essas classes de exceção podem alterar dinamicamente o HRESULT a ser retornada quando a exceção é gerada, definindo a HResult campo do objeto de exceção. Informações adicionais sobre a exceção são fornecidas para o cliente através de IErrorInfo interface, que é implementada na.NET object no processo não gerenciado.

Se você criar uma classe que estende System. Exception, você deve definir o campo HRESULT durante a construção. Caso contrário, a classe base atribui o valor HRESULT. Você pode mapear as novas classes de exceção para um HRESULT existente fornecendo o valor no construtor da exceção.

Observe que o tempo de execução, às vezes, irá ignorar uma HRESULT em casos onde há um IErrorInfo presente no segmento. Esse comportamento pode ocorrer em casos onde o HRESULT e o IErrorInfo não representam o mesmo erro.

Para criar uma nova classe de exceção e mapeá-lo para um HRESULT.

• Use o seguinte código para criar uma nova classe de exceção chamado NoAccessException e mapeá-lo para o HRESULT E_ACCESSDENIED.

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

Você pode encontrar um programa (em qualquer linguagem de programação) que usa tanto código gerenciado e ao mesmo tempo. Por exemplo, o empacotador personalizado no exemplo de código a seguir usa a Marshal.ThrowExceptionForHR (int HResult) método para lançar uma exceção com um valor específico de HRESULT. O método procura o HRESULT e gera o tipo de exceção apropriado. Por exemplo, o HRESULT no fragmento de código a seguir gera ArgumentException.

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

A tabela a seguir fornece o mapeamento completo de cada HRESULT à sua classe de exceção comparável na.NET Framework.

HRESULT	.NET exceção
MSEE_E_APPDOMAINUNLOADED	AppDomainUnloadedException
COR_E_APPLICATION	ApplicationException
COR_E_ARGUMENT ou E_INVALIDARG	ArgumentException
COR_E_ARGUMENTOUTOFRANGE	ArgumentOutOfRangeException
COR_E_ARITHMETIC ou ERROR_ARITHMETIC_OVERFLOW	ArithmeticException
COR_E_ARRAYTYPEMISMATCH	ArrayTypeMismatchException
COR_E_BADIMAGEFORMAT ou ERROR_BAD_FORMAT	BadImageFormatException
COR_E_COMEMULATE_ERROR	COMEmulateException
COR_E_CONTEXTMARSHAL	ContextMarshalException
COR_E_CORE	CoreException
NTE_FAIL	CryptographicException
COR_E_DIRECTORYNOTFOUND ou ERROR_PATH_NOT_FOUND	DirectoryNotFoundException
COR_E_DIVIDEBYZERO	DivideByZeroException
COR_E_DUPLICATEWAITOBJECT	DuplicateWaitObjectException
COR_E_ENDOFSTREAM	EndOfStreamException
COR_E_TYPELOAD	EntryPointNotFoundException
COR_E_EXCEPTION	Exceção
COR_E_EXECUTIONENGINE	ExecutionEngineException
COR_E_FIELDACCESS	FieldAccessException
COR_E_FILENOTFOUND ou ERROR_FILE_NOT_FOUND	FileNotFoundException
COR_E_FORMAT	FormatException
COR_E_INDEXOUTOFRANGE	IndexOutOfRangeException
COR_E_INVALIDCAST ou 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
OrE_POINTER COR_E_NULLREFERENCE	NullReferenceException
COR_E_OUTOFMEMORY ou E_OUTOFMEMORY	OutOfMemoryException
COR_E_OVERFLOW	OverflowException
COR_E_PATHTOOLONG ou 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
OrERROR_STACK_OVERFLOW COR_E_STACKOVERFLOW	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
Todos os outros HRESULTs.	COMException

Para recuperar informações de erro estendidas, o cliente gerenciado deve examinar os campos do objeto de exceção que foi gerado. Para o objeto de exceção fornecer informações úteis sobre um erro, o objeto COM deve implementar a IErrorInfo interface. O runtime usa as informações fornecidas por IErrorInfo para inicializar o objeto de exceção.

Se o objeto COM não suporta IErrorInfo, o runtime inicializa um objeto de exceção com valores padrão. A tabela a seguir lista cada campo associado a um objeto de exceção e identifica a fonte de informações padrão, quando o objeto COM suporta IErrorInfo.

Observe que o tempo de execução, às vezes, irá ignorar uma HRESULT em casos onde há um IErrorInfo presente no segmento. Esse comportamento pode ocorrer em casos onde o HRESULT e o IErrorInfo não representam o mesmo erro.

Campo de exceção	Fonte de informações do COM
ErrorCode	HRESULT retornado de chamada.
HelpLink	Se IErrorInfo - > HelpContext é diferente de zero, a seqüência de caracteres é formada pela concatenação IErrorInfo - > GetHelpFile e "#" e IErrorInfo - > GetHelpContext. Caso contrário, a seqüência de caracteres é retornada de IErrorInfo - > GetHelpFile.
InnerException	Sempre é uma referência nula (nada em Visual Basic).
Message (Mensagem)	Seqüência de caracteres retornada da IErrorInfo - > GetDescription.
Origem	Seqüência de caracteres retornada da IErrorInfo - > GetSource.
StackTrace	O rastreamento de pilha.
TargetSite	O nome do método que retornou a falha HRESULT.

Campos de exceção, como mensagem, fonte, e StackTrace não estão disponíveis para o StackOverflowException.

Consulte também

Conceitos

Tratamento e lançamento de exceções

Outros recursos

Interoperabilidade de COM avançadas