Метод IDebugClient4::WriteDumpFileWide (dbgeng.h)
Метод 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
Указывает строку комментария, которая будет включена в файл аварийного дампа. Эта строка отображается в консоли отладчика при загрузке файла дампа.
Возвращаемое значение
Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .
Код возврата | Описание |
---|---|
|
Метод выполнен успешно. |
Комментарии
Дополнительные сведения о файлах аварийных дампов см. в разделе Dump-File Targets.
Требования
Требование | Значение |
---|---|
Целевая платформа | Персональный компьютер |
Верхняя часть | dbgeng.h (включая Dbgeng.h) |