AfxFreeLibrary

AfxFreeLibraryAfxLoadLibrary は、読み込まれた各ライブラリのモジュールの参照カウントを保持します。

BOOL AFXAPI AfxFreeLibrary(
   HINSTANCE hInstLib 
);

パラメーター

  • hInstLib
    読み込まれたライブラリのモジュール ハンドル。AfxLoadLibrary は、このハンドルを返します。

戻り値

関数が成功した場合TRUE ; それ以外 FALSE

解説

AfxFreeLibrary 、ダイナミック リンク ライブラリの (DLL) に読み込まれたモジュールの参照カウントをデクリメントします。参照カウントがゼロに達すると、モジュールが呼び出しプロセスのアドレス空間からサイトマップになく、ハンドルは無効になります。この参照カウントは AfxLoadLibrary が呼び出されるたびにインクリメントします。

マップ解除する前にライブラリのモジュールは、を使用してプロセスからデタッチし、システム DLL ができます。そのためには、 DLL に現在の代わりに割り当てられたリソースをクリーンアップする機会を処理します示します。エントリ ポイント関数の戻りの後に、ライブラリのモジュールは、現在のプロセスのアドレス空間から削除されます。

DLL モジュールを割り当てるに AfxLoadLibrary を使用します。

アプリケーションが複数のスレッドを使用する場合に AfxFreeLibraryAfxLoadLibrary を指定してください (Win32 の代わりに FreeLibraryLoadLibraryは機能します)。AfxLoadLibraryAfxFreeLibrary を使用することによって、拡張 DLL の読み込みまたはアンロード時に実行されるスタートアップ コードと終了コードが、グローバルな MFC の状態を破損するのを防ぎます。

使用例

AfxLoadLibraryの例を参照してください。

必要条件

Header: afxdll_.h

参照

関連項目

AfxLoadLibrary

概念

MFC マクロとグローバル