AfxFreeLibrary

AfxFreeLibraryAfxLoadLibrary 用于维护每个外接库模块的引用数。

BOOL AFXAPI AfxFreeLibrary( 
   HINSTANCE hInstLib  
);

参数

  • hInstLib
    已加载库模块的句柄。 AfxLoadLibrary 返回该句柄。

返回值

如果函数成功,则为TRUE ;否则为FALSE

备注

AfxFreeLibrary 加载动态链接库 (DLL) 模块的引用数递减。 当引用计数达到零时,模块从调用进程的地址空间不处理映射,并不再有效。 每次 AfxLoadLibrary 调用,此引用计数递增。

在取消映射库模块之前,该系统使进程的 DLL 到拆离时使用它。 为此,给DLL 提供机会清理代表当前分配的处理资源。 在入口点函数返回之后,库模块从当前进程的地址空间被移除。

使用 AfxLoadLibrary 将 DLL 模块映射。

如果应用程序使用的是多线程,则它们还应使用 AfxFreeLibraryAfxLoadLibrary(而不是 Win32 函数 FreeLibraryLoadLibrary)。 使用 AfxLoadLibraryAfxFreeLibrary 可确保在加载和卸载扩展 DLL 时所执行的启动代码和关闭代码不会损坏全局 MFC 状态。

示例

请参阅 CDC::BeginPath 示例。

要求

Header: afxdll_.h

请参见

参考

AfxLoadLibrary

概念

MFC 宏和全局函数