IDebugClient4：：WriteDumpFileWide 方法 (dbgeng.h)

  • 项目

WriteDumpFileWide 方法创建用户模式或内核模式crash 转储文件。

语法

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