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

Artigo
02/06/2025

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; 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 extensão .kdmp, .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 sobre 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.

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

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

IDebugClient4

IDebugClient5

OpenDumpFile

Compartilhar via