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

Artigo
02/23/2024

O método AddDumpInformationFileWide registra arquivos adicionais que contêm informações de suporte que serão usadas ao abrir um arquivo de despejo. A versão ASCII desse método é AddDumpInformationFile.

Sintaxe

HRESULT AddDumpInformationFileWide(
  [in, optional] PCWSTR  FileName,
  [in]           ULONG64 FileHandle,
  [in]           ULONG   Type
);

Parâmetros

[in, optional] FileName

Especifica o nome do arquivo que contém as informações de suporte. Se FileHandle não for zero, FileName será usado apenas para fins informativos.

[in] FileHandle

Especifica o identificador do arquivo que contém as informações de suporte. Se FileHandle for zero, o arquivo nomeado em FileName será usado.

[in] Type

Especifica o tipo do arquivo em FileName ou FileHandle. Atualmente, há suporte apenas para arquivos que contêm informações de arquivo de paginação e Type deve ser definido como DEBUG_DUMP_FILE_PAGE_FILE_DUMP.

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

Se as informações de suporte devem ser usadas ao abrir um arquivo de despejo, esse método ou AddDumpInformationFile deve ser chamado antes que OpenDumpFile seja chamado. Se uma sessão já tiver sido iniciada, esse método não poderá ser usado.

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