AfxLoadLibrary

HINSTANCE AFXAPI AfxLoadLibrary (LPCTSTR lpszModuleName);

Значення, яке повертається

Якщо функція завершено успішно, значення, що повертається є дескриптора модуля. Якщо функцію не вдається, значення, що повертається, є NULL.

Параметри

lpszModuleName

Вказує на нульовим закінченням, що містить ім'я модуля (або на.Бібліотека DLL або.EXE файлу). Зазначене ім'я є ім'я модуля.

Якщо рядок вказує шлях, але файл відсутній у вказаний каталог, функція не вдається.

Якщо не вказано шлях і розширення імені файлу не вказано, за промовчанням розширення.Бібліотека DLL додається. Однак, рядок ім'я файлу може містити пробіли символ точку (.) вказує, що ім'я модуля не має розширення. Коли немає шляху вказано, функція виконує пошук файлу в наступну послідовність:

Зауваження

За допомогою AfxLoadLibrary карта DLL модуля. Це повертає дескриптор, які можуть бути використані в GetProcAddress , щоб отримати адресу функція DLL-Бібліотеки. AfxLoadLibrary може також використовуватися для зіставлення інші програмні модулі.

Кожен процес зберігає кількість посилань на кожен модуль завантажений бібліотеки. Ця кількість посилань піднімається кожного разу, коли AfxLoadLibrary називається і ліміту ретрансляцій зменшено кожного разу, що називається AfxFreeLibrary . Коли кількість посилань досягає нуля, модуль незакартографованої з адресного простору виклику процесу і дескриптор уже не дійсний.

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

Дивіться також AfxFreeLibrary

Index