Compartilhar via


Método ICorDebugManagedCallback2::Exception

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 [in] Um ponteiro para um objeto ICorDebugAppDomain que representa o domínio do aplicativo que contém o thread no qual a exceção foi gerada.

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

pFrame [in] 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 [in] 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 [in] Um valor da enumeração CorDebugExceptionCallbackType que especifica o tipo desse retorno de chamada de exceção.

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

Observações

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

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

O quadro e o deslocamento específicos são determinados pelo parâmetro da dwEventType seguinte maneira:

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 de 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 de captura. O deslocamento de CIL (linguagem intermediária) comum do início do manipulador catch.
DEBUG_EXCEPTION_UNHANDLED NULO Indefinido.

Requirements

Plataformas: Consulte sistemas operacionais com suporte do .NET.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET: Disponível desde o .NET Framework 2.0

Consulte também