IDebugClient5：：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) 檔案，則會搜尋擴展名為 .kdmp 的第一個檔案、.hdmp、.mdmp，最後.dmp。
[in] FileHandle
指定要開啟之傾印檔案的檔案句柄。 如果 FileHandle 為零， 則會使用 FileName 來開啟傾印檔案。 否則，如果 FileName 不是 NULL，引擎會在查詢傾印檔名時傳回它。 如果 FileHandle 不是零， 且 FileName 為 NULL，引擎會針對檔名傳回 HandleOnly 。
傳回值
這個方法也可能傳回錯誤值。 如需詳細資訊，請參閱 傳回值 。
| 傳回碼 | 描述 |
|---|---|
|
此方法成功。 |
備註
這個方法的 ASCII 版本是 OpenDumpFile。
注意 在呼叫 WaitForEvent 方法之前，引擎不會完全附加至傾印檔案。 從進程或核心建立傾印檔案時，最後一個事件的相關信息會儲存在傾印檔案中。 開啟傾印檔案之後，下次嘗試執行時，引擎就會針對事件回呼產生此事件。 只有之後，傾印檔案才會在偵錯會話中使用。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | dbgeng.h (包含 Dbgeng.h) |