Método de ICLRErrorReportingManager::BeginCustomDump

Artigo
08/08/2011

Especifica a configuração de despejos de pilha personalizado para o relatório de erros.

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

Parâmetros

dwFlavor
[in] A ECustomDumpFlavor valor que indica o tipo de despejo de pilha sobre a qual construir o despejo de pilha personalizado.
dwNumItems
[in] O comprimento da items matriz. Se dwFlavor é não DUMP_FLAVOR_Mini, dwNumItems deve ser zero.
items
[in] Uma matriz de CustomDumpItem instâncias, especificando os itens para adicionar o mini-despejo. Se dwFlavor é não DUMP_FLAVOR_Mini, items deve ser nulo.
dwReserved
[in] Reservado para uso futuro.

Valor de retorno

HRESULT	Descrição
S_OK	O método retornou com êxito.
HOST_E_CLRNOTAVAILABLE	O common language runtime (CLR) não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito.
HOST_E_TIMEOUT	A chamada foi esgotado.
HOST_E_NOT_OWNER	O chamador não possui o bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Depois de um método retornar E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE.

Comentários

O BeginCustomDump método define configuração de despejo de pilha personalizada. O EndCustomDump método limpa a configuração de despejo de pilha personalizado e libera qualquer estado associado. Deve ser chamado depois que o despejo de pilha personalizado for concluído.