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


AfxFreeLibrary

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

BOOL AFXAPI AfxFreeLibrary( 
   HINSTANCE hInstLib  
);

Параметры

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

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

если функция TRUE успешно; в противном случае — значение ЛОЖЬ.

Заметки

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

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

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

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

Пример

См. пример в разделе AfxLoadLibrary.

Требования

Header: afxdll_.h

См. также

Ссылки

AfxLoadLibrary

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

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