IDebugClient5：：OpenDumpFile 方法 (dbgeng.h)

發行項
02/23/2024

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

語法

HRESULT OpenDumpFile(
  [in] PCSTR DumpFile
);

參數

[in] DumpFile

指定要開啟的傾印檔名。 DumpFile 必須包含擴展名。 DumpFile 可以包含相對或絕對路徑;相對路徑相對於啟動調試程序的目錄。 DumpFile 可以有檔案 URL 的格式，開頭為 “file://”。如果 DumpFile 指定封包 (.cab) 檔案，則會搜尋擴展名為 .kdmp 的第一個檔案、.hdmp、.mdmp，最後.dmp。

傳回值

這個方法也可能傳回錯誤值。如需詳細資訊，請參閱傳回值。

傳回碼	描述
S_OK	此方法成功。

備註

這個方法的 Unicode 版本是 OpenDumpFileWide。

注意在呼叫 WaitForEvent 方法之前，引擎不會完全附加至傾印檔案。從進程或核心建立傾印檔案時，最後一個事件的相關信息會儲存在傾印檔案中。開啟傾印檔案之後，下次嘗試執行時，引擎就會為事件回呼產生此事件。只有在偵錯會話中，傾印檔案才會變成可用。

如需損毀傾印檔案的詳細資訊，請參閱傾印檔案目標。

規格需求

需求	值
目標平台	桌面
標頭	dbgeng.h (包含 Dbgeng.h)

另請參閱

.opendump (開啟傾印檔案)

AddDumpInformationFile

AddDumpInformationFileWide

OpenDumpFileWide