Partilhar via

Método ICLRDataTarget3::GetExceptionRecord

Chamado pelos serviços de acesso a dados CLR (Common Language Runtime) para recuperar o registro de exceção associado ao processo de destino. Por exemplo, para um destino de despejo, isso seria equivalente ao registro de exceção passado por meio do ExceptionParam argumento para a função MiniDumpWriteDump na Biblioteca de Ajuda de Depuração do Windows (DbgHelp).

Sintaxe

HRESULT GetExceptionRecord(
    [in] ULONG32 bufferSize,
    [out] ULONG32* bufferUsed,
    [out, size_is(bufferSize] BYTE* buffer
);

Parâmetros

bufferSize [em] O tamanho do buffer de entrada, em bytes. Isto tem de ser igual a sizeof(MINIDUMP_EXCEPTION).

bufferUsed [saídas] Um ponteiro para um ULONG32 tipo que recebe o número de bytes realmente gravados no buffer.

buffer [saídas] Um ponteiro para um buffer de memória que recebe uma cópia do registro de exceção. O registro de exceção é retornado como um tipo de MINIDUMP_EXCEPTION .

Devolver Valor

O valor de retorno é S_OK em êxito ou um código de falha HRESULT em falha. Os HRESULT códigos podem incluir, mas não estão limitados ao seguinte:

Código de retorno Description
S_OK Método bem sucedido. O registro de exceção foi copiado para o buffer de saída.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) Nenhum registro de exceção está associado ao destino.
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) O tamanho do buffer de entrada não é igual a sizeof(MINIDUMP_EXCEPTION).

Observações

MINIDUMP_EXCEPTION é uma estrutura definida em dbghelp.h e imagehlp.h no SDK do Windows.

Este método é implementado pelo gravador do aplicativo de depuração.

Requisitos

Plataformas: Consulte Requisitos do sistema.

Cabeçalho: ClrData.idl, ClrData.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: Disponível desde a atualização de novembro de 2013 para 4.5.1

Consulte também

  • Last updated on