Método ICLRDataTarget3::GetExceptionContextRecord
Chamado pelos serviços de acesso a dados 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 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 [em] O tamanho do buffer de entrada, em bytes. Isso deve ser grande o suficiente para acomodar o registro de contexto.
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 contexto. O registro de exceção é retornado como um tipo CONTEXT .
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 contexto foi copiado para o 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. |
Observações
CONTEXT é uma estrutura específica da plataforma definida em cabeçalhos fornecidos pelo 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
