ImageDirectoryEntryToData 函式 (dbghelp.h)

  • 發行項

取得影像特定數據的存取權。

ImageDirectoryEntryToDataEx 函式已取代此函式。 使用 ImageDirectoryEntryToDataEx 來擷取區段標頭。

語法

PVOID IMAGEAPI ImageDirectoryEntryToData(
  [in]  PVOID   Base,
  [in]  BOOLEAN MappedAsImage,
  [in]  USHORT  DirectoryEntry,
  [out] PULONG  Size
);

參數

[in] Base

映射的基位址。

[in] MappedAsImage

如果此參數為 TRUE，則檔案會由系統對應為映像。 如果旗標為 FALSE，則 MapViewOfFile 函式會將檔案對應為數據檔。

[in] DirectoryEntry

所需目錄專案的索引編號。 此參數可以是下列其中一個值。

值 意義
IMAGE_DIRECTORY_ENTRY_ARCHITECTURE
7
 架構特定數據
IMAGE_DIRECTORY_ENTRY_BASERELOC
5
 基底重新配置數據表
IMAGE_DIRECTORY_ENTRY_BOUND_IMPORT
11
 系結匯入目錄
IMAGE_DIRECTORY_ENTRY_COM_DESCRIPTOR
14
 COM 描述元數據表
IMAGE_DIRECTORY_ENTRY_DEBUG
6
 偵錯目錄
IMAGE_DIRECTORY_ENTRY_DELAY_IMPORT
13
 延遲匯入數據表
IMAGE_DIRECTORY_ENTRY_EXCEPTION
3
 例外狀況目錄
IMAGE_DIRECTORY_ENTRY_EXPORT
0
 匯出目錄
IMAGE_DIRECTORY_ENTRY_GLOBALPTR
8
 全域指標的相對虛擬位址
IMAGE_DIRECTORY_ENTRY_IAT
12
 匯入位址表
IMAGE_DIRECTORY_ENTRY_IMPORT
1
 匯入目錄
IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG
10
 載入組態目錄
IMAGE_DIRECTORY_ENTRY_RESOURCE
2
 資源目錄
IMAGE_DIRECTORY_ENTRY_SECURITY
4
 安全性目錄
IMAGE_DIRECTORY_ENTRY_TLS
9
 線程本機記憶體目錄

[out] Size

變數的指標，可接收目錄項目的數據大小，以位元組為單位。

傳回值

如果函式成功，傳回值就是目錄項目數據的指標。

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

備註

ImageDirectoryEntryToData 函式可用來取得影像特定數據的存取權。

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

規格需求

需求 值
目標平台 Windows
標頭 dbghelp.h
程式庫 Dbghelp.lib
Dll Dbghelp.dll
可轉散發套件 DbgHelp.dll 5.1 或更新版本

另請參閱

DbgHelp 函式

ImageDirectoryEntryToDataEx

MapViewOfFile