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 指定一个 cabinet （.cab） 文件，则会搜索扩展名为 .kdmp 的第一个文件，然后搜索 .hdmp、.mdmp，最后.dmp。
[in] FileHandle
指定要打开的转储文件的文件句柄。 如果 fileHandle 为零，则使用 fileName 打开转储文件。 否则，如果未 NULLFileName，则引擎在查询转储文件的名称时返回它。 如果 fileHandle 不为零，并且 FileName为 NULL，则引擎将返回文件名的 handleOnly 。
返回值
此方法也可能返回错误值。 有关详细信息，请参阅 返回值。
| 返回代码 | 描述 |
|---|---|
|
该方法成功。 |
言论
此方法的 ASCII 版本 OpenDumpFile。
注意 在调用 WaitForEvent 方法之前，引擎不会完全附加到转储文件。 从进程或内核创建转储文件时，有关最后一个事件的信息将存储在转储文件中。 打开转储文件后，下次尝试执行时，引擎将为事件回调生成此事件。 只有这样，转储文件才会在调试会话中可用。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | dbgeng.h （包括 Dbgeng.h） |