共用方式為


UpdateDebugInfoFile 函式 (imagehlp.h)

使用指定的資訊來更新符號檔中的對應欄位。

注意 此函式適用於 .dbg 檔案,而非 .pdb 檔案。
 
UpdateDebugInfoFileEx 函式已取代此函式。 使用 UpdateDebugInfoFileEx 來驗證總和檢查碼值。

語法

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

另請參閱

IMAGE_NT_HEADERS

ImageHlp 函式

UpdateDebugInfoFileEx