IDebugClient4：：WriteDumpFile 方法 (dbgeng.h)

WriteDumpFile 方法创建用户模式或 kernel-modecrash 转储文件。

语法

HRESULT WriteDumpFile(
  [in] PCSTR DumpFile,
  [in] ULONG Qualifier
);

参数

[in] DumpFile

指定要创建的转储文件的名称。 DumpFile 必须包含文件扩展名。 DumpFile 可以包含相对或绝对路径;相对路径相对于启动调试器的目录。

[in] Qualifier

指定要创建的转储文件的类型。 有关可能的值，请参阅备注。

返回值

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

返回代码	说明
S_OK	方法成功。

注解

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)

另请参阅

.dump（创建转储文件）

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

WriteDumpFile2

WriteDumpFileWide