Метод IDebugClient5::WriteDumpFileWide (dbgeng.h)

Статья
02/06/2025

Метод WriteDumpFileWide создает файл дампа в режиме пользователя или в режиме ядра.

Синтаксис

HRESULT WriteDumpFileWide(
  [in, optional] PCWSTR  FileName,
  [in]           ULONG64 FileHandle,
  [in]           ULONG   Qualifier,
  [in]           ULONG   FormatFlags,
  [in, optional] PCWSTR  Comment
);

Параметры

[in, optional] FileName

Указывает имя создаваемого файла дампа. имя файла должно включать расширение имени файла. имя_файла может включать относительный или абсолютный путь; относительные пути относятся к каталогу, в котором был запущен отладчик. Если FileHandle не NULL, Имя файла игнорируется (за исключением записи сообщений о состоянии в консоль отладчика).

[in] FileHandle

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

[in] Qualifier

Указывает тип создаваемого дампа. Возможные значения см. в DEBUG_DUMP_XXX.

[in] FormatFlags

Задает флаги, определяющие формат файла дампа и -for user-mode minidumps-то, какие сведения следует включить в файл. Дополнительные сведения см. в DEBUG_FORMAT_XXX.

[in, optional] Comment

Указывает строку комментария, которая будет включена в файл аварийного дампа. Эта строка отображается в консоли отладчика при загрузке файла дампа.

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

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

Возвращаемый код	Описание
S_OK	Метод был успешным.

Замечания

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

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	dbgeng.h (include Dbgeng.h)

См. также

.dump (создание файла дампа)

IDebugClient4

IDebugClient5

WriteDumpFile2

Поделиться через