GetModuleInformation

GetModuleInformation是計算機函式。

基本介紹

• 中文名：GetModuleInformation函式
• 外文名：GetModuleInformation
• 類別：計算機函式名
• 功能：獲取模組信息並儲存在MODULEINFO
• 返回值：如果函式成功，將返回非零數值
• hProcess：指向包含模組的進程的句柄
• lpmodinfo：指向 MODULEINFO 結構的指針

概述

GetModuleInformation 函式

獲取模組信息並儲存在 MODULEINFO 結構。

語法 Syntax

BOOL WINAPI GetModuleInformation(

__in HANDLE hProcess,

__in HMODULE hModule,

__out LPMODULEINFO lpmodinfo,

__in DWORD cb

);

參數說明 Parameters

hProcess

指向包含模組的進程的句柄。這個句柄一定要有 PROCESS_QUERY_INFORMATION 和 PROCESS_VM_READ 許可權。參考 Process Security and Access Rights

hModule

指向模組的句柄。

lpmodinfo

指向 MODULEINFO 結構的指針，該結構將會儲存關於模組的信息。

cb

結構 MODULEINFO 的大小（以位元組計算）。

返回值 Return Value

如果函式成功，將返回非零數值

如果函式失敗，將會返回 0 。調用 GetLastError 可得進一步信息。

附註 Remarks

要得到調用進程（即當前進程）的信息，可把 GetCurrentProcess返回值傳給 hProcess。

對於載入時被設定 LOAD_LIBRARY_AS_DATAFILE 標誌的模組，該函式不會返回信息。更多信息參考 LoadLibraryEx。

從 Window7 和 Windows Server 2008 R2 開始，Psapi.h 為 PSAPI 函式建立版本號。版本號會影響調用函式的名字和程式要載入的庫。（原文：Starting with Windows 7 and Windows Server 2008 R2, Psapi.h establishes version numbers for the PSAPI functions. The PSAPI version number affects the name used to call the function and the library that a program must load.）

如果 PSAPI_VERSION 是 2 或者更高，該函式將會在 Psapi.h 定義為 K32GetModuleInformation 並且由 Kernel32.lib 和 Kernel32.dll 導出。如果 PSAPI_VERSION 是 1，該函式被定義為 GetModuleInformation 並且由 Psapi.lib 和 Psapi.dll 封裝處理來調用 K32GetModuleInformation。（原文：If PSAPI_VERSION is 2 or greater, this function is defined as K32GetModuleInformation in Psapi.h and exported in Kernel32.lib and Kernel32.dll. If PSAPI_VERSION is 1, this function is defined as GetModuleInformation in Psapi.h and exported in Psapi.lib and Psapi.dll as a wrapper that calls K32GetModuleInformation.）

那些要運行在所有 Windows 版本的程式應該始終用 GetModuleInformation 名字來調用。為了確保名字正確，添加 Psapi.lib 到 TARGETLIBS macro（我不太清楚這東西，應該是說要引用 Psapi.lib）和用 –DPSAPI_VERSION=1 來編譯程式。要動態載入動態程式庫的要載入 Psapi.dll。（原文：Programs that must run on earlier versions of Windows as well as Windows 7 and later versions should always call this function as GetModuleInformation. To ensure correct resolution of symbols, add Psapi.lib to the TARGETLIBS macro and compile the program with –DPSAPI_VERSION=1. To use run-time dynamic linking, load Psapi.dll.）

要求 Requirements

客戶端最低版本	Windows 2000 專業版/Windows 2000 Professional
伺服器最低版本	Windows 2000 Server
頭檔案	Psapi.h
庫/Library	Window 7 和 Windows Server 2008 R2 下：Kernel32.lib 和 Psapi.lib（如果 PSAPI_VERSION=1 ）; Windows Server 2008,Windows Vista,Windows Server 2003 和 Windows XP/2000 下：Psapi.lib
動態程式庫/DLL	Window 7 和 Windows Server 2008 R2 下：Kernel32.dll 和 Psapi.dll（如果 PSAPI_VERSION=1 ）; Windows Server 2008,Windows Vista,Windows Server 2003 和 Windows XP/2000 下：Psapi.dll