Compartilhar via


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

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.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

.opendump (abrir arquivo de despejo)

AddDumpInformationFile

AddDumpInformationFileWide

IDebugClient4

IDebugClient5

OpenDumpFile