IDebugClient2::WriteDumpFile 方法 (dbgeng.h)

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

语法

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

参数

[in] DumpFile

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

[in] Qualifier

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

返回值

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

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

注解

WriteDumpFile、WriteDumpFile2WriteDumpFileWide 方法使用 DEBUG_DUMP_XXX 常量来指定要创建的故障转储文件类型。

可能的值包括以下内容。

一直 说明
DEBUG_DUMP_SMALL (内核模式) 或微型转储 (用户模式) 创建小型内存转储。
DEBUG_DUMP_DEFAULT 创建完全 User-Mode 转储 (用户模式) 或内核摘要转储 (内核模式) 。
DEBUG_DUMP_FULL

仅) (内核模式创建完整内存转储。

若要指定文件的格式以及要包含在文件中的用户模式 minidumps 的信息,请使用 WriteDumpFile2WriteDumpFileWide

有关故障转储文件的详细信息,请参阅 转储文件目标

此外,以下别名可用于内核模式调试。

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