FreeLibrary 函式 (libloaderapi.h)

發行項
08/24/2023

釋放載入的動態連結程式庫 (DLL) 模組，並視需要遞減其參考計數。當參考計數達到零時，模組會從呼叫進程的位址空間卸載，而且控制碼不再有效。

語法

BOOL FreeLibrary(
  [in] HMODULE hLibModule
);

參數

[in] hLibModule

載入的程式庫模組控制碼。 LoadLibrary、LoadLibraryEx、
GetModuleHandle或 GetModuleHandleEx 函式會傳回此控制碼。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError 函式。

備註

系統會針對每個載入的模組維護每個進程參考計數。因為載入時間動態連結而載入進程初始化的模組具有一個參考計數。每次呼叫 LoadLibrary載入模組時，模組的參考計數都會遞增。除非第一次載入模組，而且載入為數據或影像檔，否則參考計數也會隨著 LoadLibraryEx 的呼叫而遞增。

每次呼叫模組的FreeLibrary 或 FreeLibraryAndExitThread函式時，都會遞減參考計數。當模組的參考計數達到零或進程終止時，系統會從進程的位址空間卸載模組。卸載程式庫模組之前，系統會藉由呼叫模組的 DllMain 函式，如果模組具有，則具有 DLL_PROCESS_DETACH 值，讓模組與進程中斷連結。這麼做可讓程式庫模組有機會清除代表目前進程配置的資源。在進入點函式傳回之後，程式庫模組就會從目前處理序的位址空間中移除。

從DllMain呼叫FreeLibrary並不安全。如需詳細資訊，請參閱 DllMain中的一節。

呼叫 FreeLibrary 不會影響使用相同模組的其他進程。

使用GetModuleHandle所傳回的控制碼呼叫FreeLibrary時，請小心。 GetModuleHandle函式不會遞增模組的參考計數，因此將此控制碼傳遞至FreeLibrary可能會導致模組提前卸載。

執行緒必須卸載執行所在的 DLL，然後終止本身應該呼叫 FreeLibraryAndExitThread ，而不是個別呼叫 FreeLibrary 和 ExitThread 。否則，可能會發生競爭條件。如需詳細資訊，請參閱 FreeLibraryAndExitThread的一節。

範例

如需範例，請參閱使用動態連結 Run-Time。

需求


最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	libloaderapi.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll