Método IDebugClient3::OpenDumpFile (dbgeng.h)

Artigo
02/23/2024

O método OpenDumpFile abre um arquivo de despejo como um destino de depurador.

Sintaxe

HRESULT OpenDumpFile(
  [in] PCSTR DumpFile
);

Parâmetros

[in] DumpFile

Especifica o nome do arquivo de despejo a ser aberto. DumpFile deve incluir a extensão de nome de arquivo. DumpFile pode incluir um caminho relativo ou absoluto; os caminhos relativos são relativos ao diretório no qual o depurador foi iniciado. DumpFile pode ter a forma de uma URL de arquivo, começando com "file://". Se DumpFile especificar um arquivo de gabinete (.cab), o arquivo de gabinete será pesquisado para o primeiro arquivo com a extensão .kdmp, depois .hdmp, depois .mdmp e, por fim, .dmp.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

A versão Unicode desse método é OpenDumpFileWide.

Nota O mecanismo não é completamente anexado ao arquivo de despejo até que o método WaitForEvent tenha sido chamado. Quando um arquivo de despejo é criado com base em um processo ou kernel, as informações sobre o último evento são armazenadas no arquivo de despejo. Depois que o arquivo de despejo for aberto, na próxima tentativa de execução, o mecanismo gerará esse evento para os retornos de chamada de evento. Somente então o arquivo de despejo fica disponível na sessão de depuração.

Para obter mais informações sobre arquivos de despejo de memória, consulte Destinos de arquivo de despejo.