FreeLibrary

小甲鱼

注：本文档由 谁动了我的豆包 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

FreeLibrary 函数用于释放被加载的动态链接库（DLL）模块，并且如果有必要的话，还要递减该模块的引用计数。当引用计数的值等于 0 的时候，模块从调用线程的地址空间中释放并且句柄不再有效。


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL WINAPI FreeLibrary(
  _In_ HMODULE hModule
);

参数解析：

参数	含义
hModule	1. 该参数用于表示一个被加载的库模块句柄 2. 该句柄由 LoadLibrary 函数，LoadLibraryEx 函数，GetModuleHandle 函数或者 GetModuleHandleEx 函数返回

返回值：

1. 如果函数运行成功，该返回值为非 0；

2. 如果函数运行失败，该返回值为 0。

想要调用更多的错误信息，请调用 GetLastError 函数。


备注：

1. 系统为每个被加载的模块保留了一个每个进程的引用计数。一个模块在进程初始化的时候被加载，那是由于加载时动态链接对每个进程都有一个引用计数。当一个模块每次通过调用 LoadLibrary 函数被加载时，该模块的引用计数就会递增。通过调用 LoadLibraryEx 函数也可以是引用计数递增，除非该模块是第一次被加载并且被加载成了一个数据或者图像文件。

2. 每次对一个模块调用 FreeLibrary 函数或 FreeLibraryAndExitThread 函数时，引用计数就会递减。当一个模块的额引用计数达到0或者该进程终止了的时候，系统就会从该进程的地址空间卸载该模块了。在卸载该模块之前，如果该模块有个 DLL_PROCESS_DETACH 值，系统会通过调用该模块的 DllMain 函数使该模块与进程分离。这样做是为了个库模块一个机会，去清理当前进程被分配的资源。当入口点函数返回后，库模块就会从当前进程的地址空间中被除去。

3. 从 DLLMain 函数调用 FreeLibrary 函数是不安全的。更多信息，请参照 DllMain 函数里的备注部分。

4. 调用FreeLibrary函数不会影响使用同一模块的其它进程。当调用带有 GetModuleHandle 函数返回的句柄的 FreeLibrary 函数时，小心点。因为 GetModuleHandle 函数不会递增一个模块的引用计数，所有将该句柄传递到 FreeLibrary 函数，可能导致一个模块被过早的卸载。

5. 当一个线程运行时，该线程必须卸载 DLL，而且之后应该通过调用 FreeLibraryAndExitThread 函数而不是单独的调用 FreeLibrary 函数和 ExitThread 函数来终止自身。否则，可能发生紊乱的状况。更多细节，请参照 FreeLibraryAndExitThread 函数的备注部分。


需求：

Minimum supported client	Windows XP [桌面应用程序 | Windows 商店应用程序]
Minimum supported server	Windows 2003 服务器版 [桌面应用程序 | Windows 商店应用程序]
Minimum supported phone	Windows Phone 8
Header	Winbase.h (包含于 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。