Partilhar via

Método ICLRDataTarget3::GetExceptionContextRecord

  • Artigo

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

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 contexto. O registo de exceção é devolvido como um tipo de CONTEXTO .

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 contexto foi copiado para a memória intermédia de saída.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) Nenhum registo de contexto está associado ao destino.
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) O tamanho da memória intermédia de entrada não é grande o suficiente para acomodar o registo de contexto.

Observações

CONTEXT é uma estrutura específica da plataforma definida em cabeçalhos fornecidos pelo 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