На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

GetModuleHandle



The GetModuleHandle function returns a module handle for the specified module if the file has been mapped into the address space of the calling process.

HMODULE GetModuleHandle(

LPCTSTR lpModuleName // address of module name to return handle for
);


Parameters

lpModuleName

Points to a null-terminated string that names a Win32 module (either a .DLL or .EXE file). If the filename extension is omitted, the default library extension .DLL is appended. The filename string can include a trailing point character (.) to indicate that the module name has no extension. The string does not have to specify a path. The name is compared (case independently) to the names of modules currently mapped into the address space of the calling process.
If this parameter is NULL, GetModuleHandle returns a handle of the file used to create the calling process.



Return Values

If the function succeeds, the return value is a handle to the specified module.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks

The returned handle is not global, inheritable, or duplicative, and it cannot be used by another process.
The handles returned by GetModuleHandle and LoadLibrary can be used in the same functions ѕ for example, GetProcAddress, FreeLibrary, or LoadResource. The difference between the two functions involves the reference count. LoadLibrary maps the module into the address space of the calling process, if necessary, and increments the module's reference count, if it is already mapped. GetModuleHandle, however, returns the handle of a mapped module without incrementing its reference count.

Note that the reference count is used in FreeLibrary to determine whether to unmap the function from the address space of the process. For this reason, use care when using a handle returned by GetModuleHandle in a call to FreeLibrary because doing so can cause a dynamic-link library (DLL) module to be unmapped prematurely.
This function must also be used carefully in a multithreaded application. There is no guarantee that the module handle remains valid between the time this function returns the handle and the time it is used by another function. For example, a thread might retrieve a module handle by calling GetModuleHandle. Before the thread uses the handle in another function, a second thread could free the module and the system could load another module, giving it the same handle as the module that was recently freed. The first thread would then be left with a module handle that refers to a module different than the one intended.

See Also

FreeLibrary, GetModuleFileName, GetProcAddress, LoadLibrary, LoadResource


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetModuleHandle



Функция GetModuleHandle возвращает модульную ручку для определенного модуля если файл отображен в пространство адреса вызова процесса.

HMODULE GetModuleHandle(

АДРЕС LPCTSTR lpModuleName // модульного имени, чтобы возвращать ручку для
);


Параметры

lpModuleName

Точки на недействительный расторгнутую строку, которые называют модуль Win32 (или .DLL или файл .EXE). Если расширение filename опущено, встроенное библиотечное расширение .DLL добавлено. Строка filename может включить конечный символ точки (.), чтобы указывать, что модульное имя не имеет расширение. Строка нет должна определить путь. Имя сравнено (случай независимо) в имена модулей к настоящему времени отображенных в пространство адреса вызова процесса.
Если этот параметр НЕДЕЙСТВИТЕЛЕН, GetModuleHandle возвращает ручку файла использованного, чтобы создавать вызов процесса.



Обратные Величины

Если функция добивается успеха, обратная величина является ручкой в определенный модуль.
Если функция терпит неудачу, обратная величина НЕДЕЙСТВИТЕЛЬНА. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Возвращанная ручка - не глобальный, inheritable, или duplicative, и не может быть использовано другим процессом.
Ручки возвращались GetModuleHandle и LoadLibrary может быть использован в тех же функциях U например, GetProcAddress, FreeLibrary, или LoadResource. Различие между двумя функциями включает счет ссылки. LoadLibrary ОТОБРАЖАЕТ модуль в пространство адреса вызова процесса, если необходимо и увеличивает модульный счет ссылки, если уже отображено. GetModuleHandle, ТЕМ НЕ МЕНЕЕ, возвращает ручку отображенного модуля не увеличивая счет ссылки.

Отметьте, что счет ссылки использован в FreeLibrary, чтобы определять unmap функция из пространства адреса процесса. По этой причине, забота использования при использовании ручки возвращалась GetModuleHandle на вызове на FreeLibrary поскольку делая так может вызвать динамическую связь библиотеки (DLL) модуля, которая нужно unmapped преждевременно.
Эта функция должна также использоваться тщательно в multithreaded приложении. Нет гарантировать, что модульная ручка остается в силе между временем этим функциональным возвратом ручка и время использовано другой функцией. Например, резьба могла извлечь модульную ручку вызывая GetModuleHandle. Прежде, чем резьба использует ручку в другой функции, резьба секунды могла бы освободить модуль и система могла бы загрузить другой модуль, дающий этому ту же ручку как модуль, который недавно был освобожден. Первая резьба должна затем оставлена модульной ручкой, что имеет отношение к модульному другому чем один предположенное.

Смотри Также

FreeLibrary, GetModuleFileName, GetProcAddress, LoadLibrary, LoadResource


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz