Partilhar via


Método ICLRErrorReportingManager::BeginCustomDump

Especifica a configuração de personalizado heap Despeja 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 heap despejo na qual a criação de personalizado heap despejo.

  • dwNumItems
    [in] O comprimento do items matriz. If dwFlavor não é DUMP_FLAVOR_Mini, dwNumItems deve ser zero.

  • items
    [in] Uma matriz de CustomDumpItem instâncias, especificar os itens para adicionar o mini-despejo. If 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 linguagem tempo de execução (CLR) não foi carregado em um processo ou o CLR está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.

HOST_E_TIMEOUT

A telefonar expirou.

HOST_E_NOT_OWNER

O chamador não é proprietário do bloquear.

HOST_E_ABANDONED

Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.

E_FAIL

Ocorreu uma falha catastrófica desconhecida. Após um método retornar E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem métodos retornam HOST_E_CLRNOTAVAILABLE.

Comentários

The BeginCustomDump método define personalizado heap configuração de despejo. The EndCustomDump método limpa personalizado heap despejar a configuração e libera qualquer estado associado. Ele deve ser chamado depois que o despejo de pilha personalizado for concluído.

Observação importanteObservação importante:

Falha ao chamar EndCustomDump faz com que a memória para vazar.

Requisitos

Plataformas: See Requisitos de sistema do .NET framework.

Cabeçalho: MSCorEE.idl

Biblioteca: Incluído sistema autônomo um recurso em MSCorEE.dll

.NET Framework Versions: 3.5 SP1, 3,5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Consulte também

Referência

Estrutura CustomDumpItem

Enumeração ECustomDumpFlavor

Interface ICLRErrorReportingManager