IDebugClient2：：WriteDumpFile 方法 (dbgeng.h)
WriteDumpFile 方法创建用户模式或 kernel-modecrash 转储文件。
语法
HRESULT WriteDumpFile(
[in] PCSTR DumpFile,
[in] ULONG Qualifier
);
参数
[in] DumpFile
指定要创建的转储文件的名称。 DumpFile 必须包含文件扩展名。 DumpFile 可以包含相对或绝对路径;相对路径相对于启动调试器的目录。
[in] Qualifier
指定要创建的转储文件的类型。 有关可能的值，请参阅备注。
返回值
此方法也可能返回错误值。 有关更多详细信息 ，请参阅返回值 。
| 返回代码 | 说明 |
|---|---|
|
方法成功。 |
注解
WriteDumpFile、WriteDumpFile2 和 WriteDumpFileWide 方法使用 DEBUG_DUMP_XXX 常量来指定要创建的故障转储文件类型。
可能的值包括以下内容。
| 一直 | 说明 |
|---|---|
| DEBUG_DUMP_SMALL | (内核模式) 或微型转储 (用户模式) 创建小型内存转储。 |
| DEBUG_DUMP_DEFAULT | 创建完全 User-Mode 转储 (用户模式) 或内核摘要转储 (内核模式) 。 |
| DEBUG_DUMP_FULL |
仅) (内核模式创建完整内存转储。 |
若要指定文件的格式以及要包含在文件中的用户模式 minidumps 的信息，请使用 WriteDumpFile2 或 WriteDumpFileWide。
有关故障转储文件的详细信息，请参阅 转储文件目标。
此外，以下别名可用于内核模式调试。
| Alias | 值 |
|---|---|
| DEBUG_KERNEL_SMALL_DUMP | DEBUG_DUMP_SMALL |
| DEBUG_KERNEL_DUMP | DEBUG_DUMP_DEFAULT |
| DEBUG_KERNEL_FULL_DUMP | DEBUG_DUMP_FULL |
此外，以下别名可用于用户模式调试。
| Alias | 值 |
|---|---|
| DEBUG_USER_WINDOWS_SMALL_DUMP | DEBUG_DUMP_SMALL |
| DEBUG_USER_WINDOWS_DUMP | DEBUG_DUMP_DEFAULT |
有关内核模式转储文件的说明，请参阅 Kernel-Mode 转储文件的品种。 有关用户模式转储文件的说明，请参阅 User-Mode 转储文件的品种。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | dbgeng.h (包括 Dbgeng.h) |