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

Статья
08/07/2023

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

Синтаксис

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

Параметры

[in, optional] FileName

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

[in] FileHandle

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

[in] Qualifier

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

[in] FormatFlags

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

[in, optional] Comment

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

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

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

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

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	dbgeng.h (включая Dbgeng.h)

См. также раздел

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

IDebugClient4

IDebugClient5

WriteDumpFile2