IDebugClient5::OpenDumpFile 方法 (dbgeng.h)
OpenDumpFile 方法将打开一个转储文件作为调试器目标。
语法
HRESULT OpenDumpFile(
[in] PCSTR DumpFile
);
参数
[in] DumpFile
指定要打开的转储文件的名称。 DumpFile 必须包含文件扩展名。 DumpFile 可以包含相对路径或绝对路径;相对路径相对于启动调试器的目录。 DumpFile 可以采用文件 URL 的形式,以“file://”开头。 如果 DumpFile 指定了一个 (.cab) 文件的 cabinet 文件,则会搜索扩展名为 .kdmp、.hdmp、.mdmp 的第一个文件,最后.dmp。
返回值
此方法也可能返回错误值。 有关更多详细信息 ,请参阅返回值 。
返回代码 | 说明 |
---|---|
|
方法成功。 |
注解
此方法的 Unicode 版本为 OpenDumpFileWide。
注意 在调用 WaitForEvent 方法之前,引擎不会完全附加到转储文件。 从进程或内核创建转储文件时,有关最后一个事件的信息将存储在转储文件中。 打开转储文件后,下次尝试执行时,引擎将为事件回调生成此事件。 只有这样,转储文件才会在调试会话中可用。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |