IDebugClient5::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 可以包含相对路径或绝对路径;相对路径相对于启动调试器的目录。 如果未 NULLFileHandle,则忽略 FileName(将状态消息写入调试器控制台时除外)。

[in] FileHandle

指定要将故障转储写入到的文件的文件句柄。 如果 FileHandleNULL,则改用 FileName 中指定的文件。

[in] Qualifier

指定要创建的转储类型。 有关可能的值,请参阅 DEBUG_DUMP_XXX

[in] FormatFlags

指定用于确定转储文件和 --for user-mode minidumps--what information to include in the file 的标志。 有关详细信息,请参阅 DEBUG_FORMAT_XXX

[in, optional] Comment

指定要包含在故障转储文件中的注释字符串。 加载转储文件时,此字符串将显示在调试器控制台中。

返回值

此方法也可能返回错误值。 有关详细信息,请参阅 返回值

返回代码 描述
S_OK
该方法成功。

言论

有关故障转储文件的详细信息,请参阅 Dump-File 目标

要求

要求 价值
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)

另请参阅

.dump (创建转储文件)

IDebugClient4

IDebugClient5

WriteDumpFile2