Método IDebugClient5::OpenDumpFileWide (dbgeng.h)

Artigo
02/23/2024

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

Sintaxe

HRESULT OpenDumpFileWide(
  [in, optional] PCWSTR  FileName,
  [in]           ULONG64 FileHandle
);

Parâmetros

[in, optional] FileName

Especifica o nome do arquivo de despejo a ser aberto , a menos que FileHandle não seja zero; nesse caso, FileName é usado somente quando o mecanismo é consultado para o nome do arquivo de despejo. FileName deve incluir a extensão de nome de arquivo. FileName pode incluir um caminho relativo ou absoluto; os caminhos relativos são relativos ao diretório no qual o depurador foi iniciado. FileName também pode estar na forma de uma URL de arquivo, começando com "file://". Se FileName especificar um arquivo de gabinete (.cab), o arquivo de gabinete será pesquisado para o primeiro arquivo com a extensão .kdmp, depois .hdmp, .mdmp e, por fim, .dmp.

[in] FileHandle

Especifica o identificador de arquivo do arquivo de despejo a ser aberto. Se FileHandle for zero, FileName será usado para abrir o arquivo de despejo. Caso contrário, se FileName não for NULL, o mecanismo o retornará quando consultado para o nome do arquivo de despejo. Se FileHandle não for zero e FileName for NULL, o mecanismo retornará HandleOnly para o nome do arquivo.

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 ASCII desse método é OpenDumpFile.

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.