ImageDirectoryEntryToDataEx 函式 (dbghelp.h)

  • 發行項

在映像標頭中找出目錄專案，並傳回目錄項目的位址。 如果存在，此函式會傳回位於數據的區段標頭。

語法

PVOID IMAGEAPI ImageDirectoryEntryToDataEx(
  [in]            PVOID                 Base,
  [in]            BOOLEAN               MappedAsImage,
  [in]            USHORT                DirectoryEntry,
  [out]           PULONG                Size,
  [out, optional] PIMAGE_SECTION_HEADER *FoundHeader
);

參數

[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

變數的指標，可接收所找到之目錄項目的數據大小。

[out, optional] FoundHeader

接收數據的 IMAGE_SECTION_HEADER 結構的指標。 如果區段標頭不存在，則此參數為 NULL。

傳回值

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

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

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

規格需求

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

另請參閱

DbgHelp 函式

IMAGE_SECTION_HEADER

MapViewOfFile