共用方式為

BindImageEx 函式 (imagehlp.h)

  • 發行項

計算匯入之每個函式的虛擬位址。

語法

BOOL IMAGEAPI BindImageEx(
  [in] DWORD                    Flags,
  [in] PCSTR                    ImageName,
  [in] PCSTR                    DllPath,
  [in] PCSTR                    SymbolPath,
  [in] PIMAGEHLP_STATUS_ROUTINE StatusRoutine
);

參數

[in] Flags

系結選項。 此參數可以是下列值的組合。

值 意義
BIND_ALL_IMAGES
0x00000004
 系結此檔案之呼叫樹狀結構中的所有影像。
BIND_CACHE_IMPORT_DLLS
0x00000008
 請勿在呼叫之間捨棄快取中的 DLL 資訊。 這可改善系結大量影像時的效能。
BIND_NO_BOUND_IMPORTS
0x00000001
 請勿產生新的匯入位址表。
BIND_NO_UPDATE
0x00000002
 請勿對檔案進行變更。

[in] ImageName

要系結的檔案名。 此值可以是檔案名、部分路徑或完整路徑。

[in] DllPath

如果無法開啟 ImageName 參數所指定的檔案，所要使用的搜尋路徑根目錄。

[in] SymbolPath

要搜尋檔案對應符號檔的路徑根目錄。

[in] StatusRoutine

狀態常式的指標。 在映射系結的進度期間，會撥號狀態常式。 如需詳細資訊，請參閱 StatusRoutine。

傳回值

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

如果函式失敗，則傳回值為 FALSE。 若要擷取擴充的錯誤資訊，請呼叫 GetLastError。

備註

系結映射的套裝程式含計算每個匯入函式的虛擬位址。 然後，計算的虛擬位址會儲存在匯入映射的匯入位址資料表 (IAT) 。 因此，映射的載入速度會更快，特別是當它使用許多 DLL 時，因為系統載入器不需要計算每個匯入函式的位址。

如果可以找到對應的符號檔，則會更新其時間戳記和總和檢查碼。

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

需求

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

另請參閱

ImageHlp 函式

StatusRoutine