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