IDebugClient8：：OpenDumpFileWide2 方法 （dbgeng.h）
OpenDumpFileWide2 方法會開啟傾印檔案作為調試程序目標。
語法
HRESULT OpenDumpFileWide2(
[in, optional] PCWSTR FileName,
[in] ULONG64 FileHandle,
[in] ULONG AlternateArch
);
參數
[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。
[in] AlternateArch
指定 AlternateArch 自變數，這是IMAGE_FILE_MACHINE_* 常數。 如需詳細資訊，請參閱 Image File Machine 常數。
支援這兩個常數。
IMAGE_FILE_MACHINE_AMD64：載入，就像映像在 x64 進程中執行一樣
IMAGE_FILE_MACHINE_ARM64：載入就像映像在ARM64進程中執行一樣
只有當您使用 OpenDumpFileWide2 來開啟圖像檔案（而非傾印檔案），才能將它對應到不同的架構時，此參數才相關。 例如 ARM64X，其中 DLL 可以載入 x64/EC 進程或 ARM64 進程。
根據預設，DLL 的相關信息會使用映像標頭已定義的任何架構來呈現。 如果您使用不同的架構呼叫 OpenDumpFileWide2，則會使用傳遞的架構來呈現資訊。 這可讓您查看當 DLL 載入該進程架構時，OS 會套用的「修正」。
如需 ARM64X 的詳細資訊，請參閱 arm64X PE 檔案。
傳回值
這個方法也可能傳回錯誤值。 如需詳細資訊，請參閱 傳回值。
言論
在呼叫 WaitForEvent 方法之前，引擎不會完全附加至傾印檔案。 從進程或核心建立傾印檔案時，最後一個事件的相關信息會儲存在傾印檔案中。 開啟傾印檔案之後，下次嘗試執行時，引擎就會針對事件回呼產生這個事件。 只有這樣，傾印檔案才會在偵錯會話中使用。
如需損毀傾印檔案的詳細資訊，請參閱 Dump-File 目標。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 窗戶 |
| 標頭 | dbgeng.h （include Dbgeng.h） |