Compartilhar via

Método ICorDebugManagedCallback2::Exception

  • Artigo

Notifica o depurador de que uma pesquisa por um manipulador de exceção foi iniciada.

Sintaxe

HRESULT Exception (
    [in] ICorDebugAppDomain   *pAppDomain,
    [in] ICorDebugThread      *pThread,
    [in] ICorDebugFrame       *pFrame,
    [in] ULONG32              nOffset,
    [in] CorDebugExceptionCallbackType dwEventType,
    [in] DWORD                dwFlags
);

Parâmetros

pAppDomain [em] Um ponteiro para um objeto ICorDebugAppDomain que representa o domínio do aplicativo que contém o thread no qual a exceção foi lançada.

pThread [em] Um ponteiro para um objeto ICorDebugThread que representa o thread no qual a exceção foi lançada.

pFrame [em] Um ponteiro para um objeto ICorDebugFrame que representa um quadro, conforme determinado pelo dwEventType parâmetro. Para obter mais informações, consulte a tabela na seção Comentários.

nOffset [em] Um inteiro que especifica um deslocamento, conforme determinado pelo dwEventType parâmetro. Para obter mais informações, consulte a tabela na seção Comentários.

dwEventType [em] Um valor da enumeração CorDebugExceptionCallbackType que especifica o tipo desse retorno de chamada de exceção.

dwFlags [em] Um valor da enumeração CorDebugExceptionFlags que especifica informações adicionais sobre a exceção

Comentários

O retorno de chamada Exception é chamado em vários pontos durante a fase de pesquisa do processo de tratamento de exceções. Ou seja, poderá ser chamado mais de uma vez enquanto libera uma exceção.

A exceção processada poderá ser recuperada do objeto ICorDebugThread referenciado pelo parâmetro pThread.

O quadro específico e o deslocamento serão determinados pelo parâmetro dwEventType conforme a seguir:

Valor de dwEventType Valor de pFrame Valor de nOffset
DEBUG_EXCEPTION_FIRST_CHANCE O quadro que gerou a exceção. O ponteiro de instrução no quadro.
DEBUG_EXCEPTION_USER_FIRST_CHANCE O quadro de código do usuário mais próximo do ponto da exceção gerada. O ponteiro de instrução no quadro.
DEBUG_EXCEPTION_CATCH_HANDLER_FOUND O quadro que contém o manipulador catch. O deslocamento da linguagem intermediária comum (CIL) do início do manipulador de capturas.
DEBUG_EXCEPTION_UNHANDLED NULO Indefinido.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 2.0

Confira também