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