IDebugClient5::OpenDumpFileWide 方法 (dbgeng.h)

OpenDumpFileWide 方法會將傾印檔案開啟為調試程序目標。

語法

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

參數

[in, optional] FileName

指定要開啟的傾印檔名-- 除非 FileHandle 不是零,在此情況下,只有在查詢引擎以取得傾印檔名時,才會使用 FileNameFileName 必須包含擴展名。 FileName 可以包含相對或絕對路徑;相對路徑相對於啟動調試程序的目錄。 FileName 也可以採用檔案 URL 的格式,開頭為 “file://”。 如果 FileName 指定封包 (.cab) 檔案,則會搜尋擴展名為 .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