Partilhar via

Método ICLRDataTarget3::GetExceptionRecord

  • Artigo

Chamado pelos serviços comuns de acesso a dados de runtime de linguagem (CLR) para obter o registo de exceção associado ao processo de destino. Por exemplo, para um destino de captura, isto seria equivalente ao registo de exceção transmitido através 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
[in] O tamanho da memória intermédia de entrada, em bytes. Tem de ser igual a sizeof(MINIDUMP_EXCEPTION).

bufferUsed
[fora] Um ponteiro para um ULONG32 tipo que recebe o número de bytes escritos na memória intermédia.

buffer
[fora] Um ponteiro para uma memória intermédia que recebe uma cópia do registo de exceção. O registo de exceção é devolvido como um tipo de MINIDUMP_EXCEPTION .

Devolver Valor

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

Código de retorno Descrição
S_OK O método foi bem-sucedido. O registo de exceção foi copiado para a memória intermédia de saída.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) Nenhum registo de exceção está associado ao destino.
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) O tamanho da memória intermédia 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 escritor da aplicação de depuração.

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: ClrData.idl, ClrData.h

Biblioteca: CorGuids.lib

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

Ver também