ICLRDataTarget3::Método GetExceptionContextRecord

Artigo
11/05/2024

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

Sintaxe

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

Parâmetros

bufferSize [em] O tamanho do buffer de entrada, em bytes. Deve ser grande o suficiente para acomodar o registro de contexto.

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

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

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 contexto foi copiado no buffer de saída.
`HRESULT_FROM_WIN32(ERROR_NOT_FOUND)`	Nenhum registro de contexto está associado ao destino.
`HRESULT_FROM_WIN32(ERROR_BAD_LENGTH)`	O tamanho do buffer de entrada não é grande o suficiente para acomodar o registro de contexto.

Comentários

CONTEXT é uma estrutura específica da plataforma definida nos cabeçalhos fornecidos pelo SDK do Windows.

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

Compartilhar via