AfxLoadLibrary

HINSTANCE AFXAPI AfxLoadLibrary (LPCTSTR lpszModuleName);

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение является дескриптором к модулю. Если вызов функции был неуспешен, возвращаемое значение равно NULL.

Параметры

lpszModuleName

Указывает на ограниченную значением null строку, содержащую имя модуля (либо.DLL или.EXE-файл). Указанное имя является именем файла модуля.

Если строка указывает путь, но файл не существует в указанном каталоге, функция не работает.

Если путь не указан, и отсутствует расширение имени файла, расширение по умолчанию.Добавляются в библиотеку DLL. Тем не менее строка имени файла может включать конечный символ точки (.) для обозначения, что имя модуля без расширения. Если путь не указан, функция ищет файл в следующей последовательности:

Каталог, из которого загружается приложение.
Текущий каталог.
Windows 95: Каталог системы Windows. Windows NT: 32-Разрядные Windows каталог системы. Имя этого каталога является SYSTEM32.
Только Windows NT: 16-Разрядные Windows каталог системы. Нет функции Win32, получивший путь к этому каталогу, но он ищется. Имя этого каталога является система.
Каталог Windows.
Каталоги, указанные в переменной среды PATH.

Примечания

Используется AfxLoadLibrary DLL-модуля. Возвращает дескриптор, который может быть использован в GetProcAddress для того чтобы получить адрес функции DLL. AfxLoadLibrary может также использоваться для сопоставления другие исполняемые модули.

Каждый процесс ведется свой счетчик ссылок для каждого модуля, загруженного библиотеки. Этот счетчик ссылок увеличивается каждый раз, когда вызывается AfxLoadLibrary и уменьшается на единицу каждый раз, когда вызывается AfxFreeLibrary . Когда счетчик ссылок достигает нуля, модуль несопоставленные из адресного пространства вызывающего процесса и ручки больше не является допустимым.

Не забудьте использовать AfxLoadLibrary и AfxFreeLibrary (вместо функций Win32 LoadLibrary и FreeLibrary) Если ваше приложение использует несколько потоков. С помощью AfxLoadLibrary и AfxFreeLibrary гарантирует, что код запуска и завершения работы, который выполняется, когда загружается и выгружается DLL расширения не коррумпированные глобальные состояния MFC.

См. также AfxFreeLibrary

Index