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

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; 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 extensão .kdmp, .hdmp, .mdmp e, por fim, .dmp.

Valor de retorno

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

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

Observações

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

Observação 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 a partir de 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. Só 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 falhas, consulte Dump-File Targets.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Consulte também

.opendump (arquivo de despejo aberto)

AddDumpInformationFile

AddDumpInformationFileWide

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

OpenDumpFileWide