На главную

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 | Скачать Вниз

GetProcAddress



The GetProcAddress function returns the address of the specified exported dynamic-link library (DLL) function.

FARPROC GetProcAddress(

HMODULE hModule, // handle to DLL module
LPCSTR lpProcName // name of function
);


Parameters

hModule

Identifies the DLL module that contains the function. The LoadLibrary or GetModuleHandle function returns this handle.

lpProcName

Points to a null-terminated string containing the function name, or specifies the function's ordinal value. If this parameter is an ordinal value, it must be in the low-order word; the high-order word must be zero.



Return Values

If the function succeeds, the return value is the address of the DLL's exported function.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks

The GetProcAddress function is used to retrieve addresses of exported functions in DLLs.
The spelling and case of the function name pointed to by lpProcName must be identical to that in the EXPORTS statement of the source DLL's module-definition (.DEF) file.
The lpProcName parameter can identify the DLL function by specifying an ordinal value associated with the function in the EXPORTS statement. GetProcAddress verifies that the specified ordinal is in the range 1 through the highest ordinal value exported in the .DEF file. The function then uses the ordinal as an index to read the function's address from a function table. If the .DEF file does not number the functions consecutively from 1 to N (where N is the number of exported functions), an error can occur where GetProcAddress returns an invalid, non-NULL address, even though there is no function with the specified ordinal.

In cases where the function may not exist, the function should be specified by name rather than by ordinal value.

See Also

FreeLibrary, GetModuleHandle, LoadLibrary


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

GetProcAddress



Функция GetProcAddress возвращает адрес определенной динамической связи экспортируемой библиотеки (DLL) функции.

FARPROC GetProcAddress(

HMODULE hModule, // РУЧКА в модуль DLL имени LPCSTR lpProcName // функции
);


Параметры

hModule

Идентифицирует модуль DLL, который содержит функцию. LoadLibrary Или функциональный возврат GetModuleHandle этой ручки.

lpProcName

Точки на недействительный расторгнутую строку, содержащие функциональное имя или определяет функциональную порядковую величину. Если этот параметр является порядковой величиной, он должен быть в младшем слове; старшее слово должно - нулевым.



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

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

Замечания

Функция GetProcAddress использована, чтобы извлекать адресы экспортируемых функций в DLLs.
Орфография и случай функционального имени указывались, чтобы lpProcName должны быть идентичны, что в утверждении ЭКСПОРТА исходного DLL's модульное-определение (.ОПРЕДЕЛЕННЫЙ) файл.
Параметр lpProcName может идентифицировать DLL функционирует определяя порядковую величину связывался функцией в утверждении ЭКСПОРТА. GetProcAddress ПРОВЕРЯЕТ, что определенный порядковый - в дипазоне 1 через самую верхнюю порядковую величину экспортированную в файл .DEF. Функция затем использует порядковый как индекс, чтобы читать функциональный адрес из функциональной таблицы. Если файл .DEF не перечисляет функции последовательно от 1 до N (где N - количество экспортируемых функций), ошибка может произойти где GetProcAddress возвращает инвалида, не-НЕДЕЙСТВИТЕЛЬНОГО адреса, даже если нет функции с определенным порядковым.

В случаях где функция не может существовать, функция должна определяться по имени а не порядковой величиной.

Смотри Также

FreeLibrary, GetModuleHandle, LoadLibrary


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