Método ICLRErrorReportingManager::BeginCustomDump

Artigo
05/10/2023

Especifica a configuração de informações de falha de sistema personalizadas 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 informação de falha de sistema da área de dados sobre a qual pode criar a captura de área dinâmica personalizada.

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

items
[in] Uma matriz de instâncias CustomDumpItem , especificando os itens a adicionar à mini-captura. Se dwFlavor não for DUMP_FLAVOR_Mini, items deve ser nulo.

dwReserved
[in] Reservado para utilização futura.

Devolver Valor

HRESULT	Description
S_OK	O método foi devolvido com êxito.
HOST_E_CLRNOTAVAILABLE	O runtime de linguagem comum (CLR) não foi carregado para um processo ou o CLR está num estado em que não pode executar código gerido ou processar a chamada com êxito.
HOST_E_TIMEOUT	A chamada excedeu o limite de tempo.
HOST_E_NOT_OWNER	O autor da chamada não é o proprietário do bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera do mesmo.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Depois de um método devolver E_FAIL, o CLR já não é utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE.

Observações

O BeginCustomDump método define a configuração de captura de área dinâmica personalizada. O método EndCustomDump limpa a configuração de captura de área dinâmica personalizada e liberta qualquer estado associado. Deve ser chamado depois de a informação de falha de sistema personalizada estar concluída.

Importante

A falha na chamada EndCustomDump faz com que a memória vaze.

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: MSCorEE.h

Biblioteca: Incluído como um recurso no MSCorEE.dll

.NET Framework Versões: Disponível desde 2.0

Partilhar via