Метод IDebugClient4::AddDumpInformationFileWide (dbgeng.h)

Статья
08/07/2023

Метод AddDumpInformationFileWide регистрирует дополнительные файлы, содержащие вспомогательные сведения, которые будут использоваться при открытии файла дампа. Версия этого метода ASCII — AddDumpInformationFile.

Синтаксис

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

Параметры

[in, optional] FileName

Указывает имя файла, содержащего вспомогательные сведения. Если FileHandle не равно нулю, FileName используется только в информационных целях.

[in] FileHandle

Указывает дескриптор файла, содержащего вспомогательные сведения. Если FileHandle равно нулю, используется файл с именем FileName .

[in] Type

Указывает тип файла в fileName или FileHandle. В настоящее время поддерживаются только файлы, содержащие сведения о файлах подкачки, а для параметра Type необходимо задать DEBUG_DUMP_FILE_PAGE_FILE_DUMP.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата	Описание
S_OK	Метод выполнен успешно.

Если при открытии файла дампа необходимо использовать вспомогательные сведения, необходимо вызвать этот метод или AddDumpInformationFile перед вызовом OpenDumpFile . Если сеанс уже запущен, этот метод нельзя использовать.

Дополнительные сведения о файлах аварийного дампа см. в разделе Dump-File Targets.