UpdateDebugInfoFile 函式 (imagehlp.h)
使用指定的資訊來更新符號檔中的對應欄位。
注意 此函式適用於 .dbg 檔案,而非 .pdb 檔案。
語法
BOOL IMAGEAPI UpdateDebugInfoFile(
[in] PCSTR ImageFileName,
[in] PCSTR SymbolPath,
[out] PSTR DebugFilePath,
[in] PIMAGE_NT_HEADERS32 NtHeaders
);
參數
[in] ImageFileName
其符號檔現在已過期的影像名稱。
[in] SymbolPath
要在其中尋找符號檔的路徑。
[out] DebugFilePath
緩衝區的指標,接收已更新之符號檔的名稱。
[in] NtHeaders
指定新標頭資訊的 IMAGE_NT_HEADERS 結構的指標。
傳回值
如果函式成功,則傳回值為 TRUE。
如果函式失敗,則傳回值為 FALSE。 若要擷取擴充的錯誤資訊,請呼叫 GetLastError。
備註
UpdateDebugInfoFile 函式會取得儲存在 IMAGE_NT_HEADERS 結構中的資訊,並更新符號檔中的對應欄位。 每當圖像檔修改時,應該呼叫此函式以保持數位同步。具體來說,每當影像總和檢查碼變更時,應該更新符號檔以符合。
所有 ImageHlp 函式,例如此函式都是單個線程。 因此,從多個線程呼叫此函式可能會導致非預期的行為或記憶體損毀。 若要避免這種情況,您必須將所有並行呼叫從多個線程同步處理到此函式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | imagehlp.h |
程式庫 | Imagehlp.lib |
Dll | Imagehlp.dll |