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 不是零 ,而且 fileNameNULL,則引擎會傳回檔名 HandleOnly。
傳回值
這個方法也可能傳回錯誤值。 如需詳細資訊,請參閱 傳回值。
傳回碼 | 描述 |
---|---|
|
方法成功。 |
言論
此方法的 ASCII 版本 OpenDumpFile。
注意 引擎不會完全附加至傾印檔案,直到呼叫 WaitForEvent 方法為止。 從進程或核心建立傾印檔案時,最後一個事件的相關信息會儲存在傾印檔案中。 開啟傾印檔案之後,下次嘗試執行時,引擎就會針對事件回呼產生這個事件。 只有這樣,傾印檔案才會在偵錯會話中使用。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | dbgeng.h (include Dbgeng.h) |