Método ICLRErrorReportingManager::BeginCustomDump

Artigo
05/10/2023

Especifica a configuração de despejos de heap personalizados para relatórios de erros.

Sintaxe

HRESULT BeginCustomDump (  
    [in] ECustomDumpFlavor dwFlavor,  
    [in] DWORD dwNumItems,  
    [in, size_is(dwNumItems), length_is(dwNumItems)] CustomDumpItem items[],  
    DWORD dwReserved  
);

Parâmetros

dwFlavor
[in] Um valor ECustomDumpFlavor que indica o tipo de despejo de heap no qual criar o despejo de heap personalizado.

dwNumItems
[in] O comprimento da matriz items. Se dwFlavor não for DUMP_FLAVOR_Mini, dwNumItems deverá ser zero.

items
[in] Uma matriz de instâncias CustomDumpItem, especificando os itens a serem adicionados ao mini-despejo. Se dwFlavor não for DUMP_FLAVOR_Mini, items deverá ser nulo.

dwReserved
[in] Reservado para uso futuro.

Valor Retornado

HRESULT	Descrição
S_OK	O método foi retornado com êxito.
HOST_E_CLRNOTAVAILABLE	O CLR (Common Language Runtime) não foi carregado em um processo ou está em um estado no qual não pode executar o código gerenciado ou processar a chamada com sucesso.
HOST_E_TIMEOUT	Uma chamada atingiu o tempo limite.
HOST_E_NOT_OWNER	O chamador não possui o bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado enquanto uma fibra ou um thread bloqueado estava esperando por ele.
E_FAIL	Uma falha catastrófica desconhecida ocorreu. Depois que um método retorna E_FAIL, o CLR não pode mais ser usado no processo. Chamadas subsequentes para métodos de hospedagem retornam HOST_E_CLRNOTAVAILABLE.

Comentários

O método BeginCustomDump define a configuração de despejo de heap personalizado. O método EndCustomDump limpa a configuração de despejo de heap personalizado e libera qualquer estado associado. Ele deve ser chamado após a conclusão do despejo de heap personalizado.

Importante

A falha na chamada para EndCustomDump faz com que ocorra vazamento de memória.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: MSCorEE.h

Biblioteca: incluída como um recurso no MSCorEE.dll

Versões do .NET Framework: disponíveis desde 2.0

Compartilhar via