共用方式為


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 方法為止。 從進程或核心建立傾印檔案時,最後一個事件的相關信息會儲存在傾印檔案中。 開啟傾印檔案之後,下次嘗試執行時,引擎就會針對事件回呼產生這個事件。 只有這樣,傾印檔案才會在偵錯會話中使用。
 
如需損毀傾印檔案的詳細資訊,請參閱 Dump-File 目標

要求

要求 價值
目標平臺 桌面
標頭 dbgeng.h (include Dbgeng.h)

另請參閱

.opendump (開啟傾印檔案)

AddDumpInformationFile

AddDumpInformationFileWide

IDebugClient4

IDebugClient5

OpenDumpFile