Método ICLRDataTarget3::GetExceptionRecord
Chamado pelos serviços de acesso a dados 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 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 [em] O tamanho do buffer de entrada, em bytes. Isto tem de ser igual a sizeof(MINIDUMP_EXCEPTION).
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 exceção. O registro de exceção é retornado como um tipo de MINIDUMP_EXCEPTION .
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 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 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 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
