IDebugClient4::OpenDumpFileWide 方法 (dbgeng.h)

OpenDumpFileWide 方法打开一个转储文件作为调试器目标。

语法

HRESULT OpenDumpFileWide(
  [in, optional] PCWSTR  FileName,
  [in]           ULONG64 FileHandle
);

参数

[in, optional] FileName

指定要打开的转储文件的名称 -- 除非 FileHandle 不为零,在这种情况下,仅当查询引擎以获取转储文件的名称时,才使用 FileNameFileName 必须包含文件扩展名。 FileName 可以包含相对路径或绝对路径;相对路径相对于启动调试器的目录。 FileName 也可以采用文件 URL 的形式,以“file://”开头。 如果 FileName (.cab) 文件指定了一个 cabinet 文件,则会搜索扩展名为 .kdmp 的第一个文件,然后是 .hdmp,然后是 .mdmp,最后.dmp。

[in] FileHandle

指定要打开的转储文件的文件句柄。 如果 FileHandle 为零,则使用 FileName 打开转储文件。 否则,如果 FileName 不为 NULL,则引擎在查询转储文件的名称时返回它。 如果 FileHandle 不为零且 FileNameNULL,则引擎将为文件名返回 HandleOnly

返回值

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

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

注解

此方法的 ASCII 版本为 OpenDumpFile

注意 在调用 WaitForEvent 方法之前,引擎不会完全附加到转储文件。 从进程或内核创建转储文件时,有关最后一个事件的信息将存储在转储文件中。 打开转储文件后,下次尝试执行时,引擎将为事件回调生成此事件。 只有这样,转储文件才会在调试会话中可用。
 
有关故障转储文件的详细信息,请参阅 转储文件目标

要求

要求
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)

另请参阅

.opendump(打开转储文件)

AddDumpInformationFile

AddDumpInformationFileWide

IDebugClient4

IDebugClient5

OpenDumpFile