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 |