FreeLibrary

原文链接 -> 传送门

函数功能：

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


API 函数原型：

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

BOOL WINAPI FreeLibrary(
  _In_ HMODULE hModule
);

参数解析：

返回值：

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 函数的备注部分。


需求：