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