MapAndLoad 函式 (imagehlp.h)

對應影像，並從對應的檔案預先載入資料。

語法

BOOL IMAGEAPI MapAndLoad(
  [in]  PCSTR         ImageName,
  [in]  PCSTR         DllPath,
  [out] PLOADED_IMAGE LoadedImage,
  [in]  BOOL          DotDll,
  [in]  BOOL          ReadOnly
);

參數

[in] ImageName

載入的映射檔案名 (可執行檔或 DLL) 。

[in] DllPath

如果找不到提供的名稱，則用來尋找影像的路徑。 如果此參數為 Null，則會套用使用 SearchPath 函式所設定的搜尋路徑規則。

[out] LoadedImage

LOADED_IMAGE結構的指標，會在載入影像後接收影像的相關資訊。

[in] DotDll

如果映射名稱不包含副檔名，則要使用的預設副檔名。 如果值為 TRUE，則會使用 .DLL 延伸模組。 如果值為 FALSE，則會使用 .EXE 擴充功能。

[in] ReadOnly

存取模式。 如果此值為 TRUE，則檔案會對應為唯讀存取。 如果值為 FALSE，則會對應檔案以進行讀取和寫入存取。

傳回值

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

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

備註

MapAndLoad函式會對應影像，並從對應的檔案預先載入資料。 對應的 函式 UnMapAndLoad必須用來解除配置 MapAndLoad 函式所配置的所有資源。

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

需求

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

另請參閱

ImageHlp 函式

LOADED_IMAGE

UnMapAndLoad