共用方式為

updateDebugInfoFileEx 函式 (imagehlp.h)

  • 發行項

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

注意 此函式適用於 .dbg 檔案，而非 .pdb 檔案。
 

語法

BOOL IMAGEAPI UpdateDebugInfoFileEx(
  [in]  PCSTR               ImageFileName,
  [in]  PCSTR               SymbolPath,
  [out] PSTR                DebugFilePath,
  [in]  PIMAGE_NT_HEADERS32 NtHeaders,
  [in]  DWORD               OldCheckSum
);

參數

[in] ImageFileName

相對於其符號檔，現在已過期的影像名稱。

[in] SymbolPath

要在其中尋找符號檔的路徑。

[out] DebugFilePath

緩衝區的指標，接收已更新之符號檔的名稱。

[in] NtHeaders

指定新標頭資訊的 IMAGE_NT_HEADERS 結構的指標。

[in] OldCheckSum

原始總和檢查碼值。 如果此值不符合對應影像中存在的總和檢查碼，符號檔中的旗標會包含IMAGE_SEPARATE_DEBUG_MISMATCH，而最後一個錯誤值會設定為 ERROR_INVALID_DATA。

傳回值

如果函式成功，則傳回值為 TRUE。

如果函式失敗，傳回值為 FALSE。

備註

UpdateDebugInfoFileEx 函式會採用儲存在IMAGE_NT_HEADERS結構中的資訊，並更新符號檔中的對應字段。 每當修改圖像檔時，都應該呼叫此函式，讓數位保持同步。具體來說，每當影像總和檢查碼變更時，應該更新符號檔以符合。

所有 ImageHlp 函式，例如此函式都是單個線程。 因此，從一個以上的線程呼叫此函式可能會導致非預期的行為或記憶體損毀。 若要避免這種情況，您必須將所有並行呼叫從一個以上的線程同步至此函式。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 imagehlp.h
程式庫 Imagehlp.lib
Dll Imagehlp.dll

另請參閱

IMAGE_NT_HEADERS

ImageHlp 函式