Поделиться через


AfxFreeLibrary

И AfxFreeLibrary и AfxLoadLibrary поддерживают счетчика ссылок для каждого модуля, загружаемой библиотеки.

BOOL AFXAPI AfxFreeLibrary(
   HINSTANCE hInstLib 
);

Параметры

  • hInstLib
    Дескриптор модуля, загружаемой библиотеки.AfxLoadLibrary возвращает дескриптор.

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

Истина если функция завершается успешно; в противном случае – значение Ложь.

Заметки

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

Перед unmapping модуль система позволяет библиотеки DLL, чтобы наконец удалить из процессов его использование.Это обеспечивает библиотека DLL возможность очистить ресурсы, выделенные именем текущего.После того как функция точки входа возвращает модуль библиотеки удален из текущего адресного пространства процесса.

Используйте AfxLoadLibrary для сопоставления модуль DLL.

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

Пример

См. пример для AfxLoadLibrary.

Требования

Header: afxdll_.h

См. также

Ссылки

AfxLoadLibrary

Основные понятия

Макросы и глобальные MFC