Método de ICorDebugManagedCallback2::Exception

Artigo
08/08/2011

Notifica o depurador que começou uma pesquisa para um manipulador de exceção.

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

Parâmetros

pAppDomain
[in] Um ponteiro para um ICorDebugAppDomain o objeto que representa o domínio de aplicativo que contém o segmento no qual a exceção foi lançada.
pThread
[in] Um ponteiro para um ICorDebugThread o objeto que representa o segmento no qual a exceção foi lançada.
pFrame
[in] Um ponteiro para um ICorDebugFrame o objeto que representa um quadro, conforme determinado pelo dwEventType parâmetro. Para obter mais informações, consulte a tabela na seção comentários.
nOffset
[in] Um inteiro que especifica o deslocamento, conforme determinado pelo dwEventType parâmetro. Para obter mais informações, consulte a tabela na seção comentários.
dwEventType
[in] Um valor igual a CorDebugExceptionCallbackType enumeração que especifica o tipo de retorno de chamada esta exceção.
dwFlags
[in] Um valor igual a CorDebugExceptionFlags enumeração que especifica informações adicionais sobre a exceção

Comentários

O Exception é chamado de retorno de chamada em vários pontos durante a fase de pesquisa do processo de manipulação de exceção. Ou seja, ele pode ser chamado mais de uma vez durante o desenrolar a exceção.

A exceção que está sendo processada pode ser recuperada da ICorDebugThread objeto referenciado pela pThread parâmetro.

O quadro em particular e o deslocamento são determinados pelo dwEventType parâmetro da seguinte maneira:

Valor dedwEventType	Valor depFrame	Valor denOffset
DEBUG_EXCEPTION_FIRST_CHANCE	O quadro que lançou a exceção.	O ponteiro de instrução no quadro.
DEBUG_EXCEPTION_USER_FIRST_CHANCE	O quadro de código do usuário próximo ao 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 a Microsoft intermediate language (MSIL) do início do manipulador catch.
DEBUG_EXCEPTION_UNHANDLED	NULL	Indefinido.