Método ICLRDataTarget3::GetExceptionRecord

  • Artigo

Chamado pelo serviço de acesso a dados do 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 argumento ExceptionParam à 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
[in] O tamanho do buffer de entrada, em bytes. Isso deve ser igual a sizeof(MINIDUMP_EXCEPTION).

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

buffer
[out] 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.

Valor Retornado

O valor retornado é S_OK em caso de êxito, ou um código de falha HRESULT em caso de falha. Os códigos HRESULT podem incluir, entre outros:

Código de retorno Descrição
S_OK O método foi 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 à sizeof(MINIDUMP_EXCEPTION).

Comentários

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

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

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: ClrData.idl, ClrData.h

Biblioteca: CorGuids.lib

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

Confira também