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
指定要包含在故障转储文件中的注释字符串。 加载转储文件时，此字符串将显示在调试器控制台中。
返回值
此方法也可能返回错误值。 有关更多详细信息 ，请参阅返回值 。
| 返回代码 | 说明 |
|---|---|
|
方法成功。 |
注解
有关故障转储文件的详细信息，请参阅 转储文件目标。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | dbgeng.h (包括 Dbgeng.h) |