Функция GetModuleInformation (psapi.h)
Извлекает сведения об указанном модуле в структуре MODULEINFO .
Синтаксис
BOOL GetModuleInformation(
[in] HANDLE hProcess,
[in] HMODULE hModule,
[out] LPMODULEINFO lpmodinfo,
[in] DWORD cb
);
Параметры
[in] hProcess
Дескриптор процесса, содержащего модуль.
Дескриптор должен иметь права доступа PROCESS_QUERY_INFORMATION и PROCESS_VM_READ . Дополнительные сведения см. в разделе Управление правами на доступ и безопасность процесса.
[in] hModule
Дескриптор модуля.
[out] lpmodinfo
Указатель на структуру MODULEINFO , которая получает сведения о модуле.
[in] cb
Размер структуры MODULEINFO в байтах.
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Чтобы получить сведения о вызывающем процессе, передайте дескриптор, возвращенный Методом GetCurrentProcess.
Функция GetModuleInformation не получает сведения о модулях, загруженных с флагом LOAD_LIBRARY_AS_DATAFILE . Дополнительные сведения см. в разделе LoadLibraryEx.
Начиная с Windows 7 и Windows Server 2008 R2, Psapi.h устанавливает номера версий для функций PSAPI. Номер версии PSAPI влияет на имя, используемое для вызова функции, и библиотеку, которую должна загрузить программа.
Если PSAPI_VERSION имеет значение 2 или больше, эта функция определяется как K32GetModuleInformation в Psapi.h и экспортируется в Kernel32.lib и Kernel32.dll. Если PSAPI_VERSION равно 1, эта функция определяется как K32GetModuleInformation в Psapi.h и экспортируется в Psapi.lib и Psapi.dll в качестве оболочки, которая вызывает K32GetModuleInformation.
Программы, которые должны выполняться в более ранних версиях Windows, а также Windows 7 и более поздних версиях, всегда должны вызывать эту функцию как K32GetModuleInformation. Чтобы обеспечить правильное разрешение символов, добавьте Psapi.lib в макрос TARGETLIBS и скомпилируйте программу с параметром -DPSAPI_VERSION=1. Чтобы использовать динамическое связывание во время выполнения, загрузите Psapi.dll.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2003 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | psapi.h |
| Библиотека | Kernel32.lib в Windows 7 и Windows Server 2008 R2; Psapi.lib (если PSAPI_VERSION=1) в Windows 7 и Windows Server 2008 R2; Psapi.lib в Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP |
| DLL | Kernel32.dll в Windows 7 и Windows Server 2008 R2; Psapi.dll (если PSAPI_VERSION=1) в Windows 7 и Windows Server 2008 R2; Psapi.dll в Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP |