AfxFreeLibrary
AfxFreeLibrary と AfxLoadLibrary は、それぞれの読み込まれたライブラリ モジュールの参照カウントを保持します。
BOOL AFXAPI AfxFreeLibrary(
HINSTANCE hInstLib
);
パラメーター
- hInstLib
読み込まれたライブラリ モジュール ハンドル。 AfxLoadLibrary は このハンドルを返します。
戻り値
関数が成功した場合TRUE ; それ以外の場合は FALSE。
解説
AfxFreeLibrary は ダイナミック リンク ライブラリ (DLL) の読み込まれたモジュールの参照カウントをデクリメントします。 参照カウントがゼロに達すると、モジュールは、呼び出し元プロセスのアドレス空間から未割り当てになく、ハンドルは無効になります。 この参照カウントが AfxLoadLibrary が呼び出されるたびにインクリメントされます。
いったんの前にライブラリ モジュールは、システム DLL を使うプロセスからデタッチすることができます。 そのためには、DLL に現在のプロセスによって割り当てられたリソースをクリーンアップすることができます。 エントリ ポイント関数が戻った後に、ライブラリのモジュールでは、現在のプロセスのアドレス空間から削除されます。
DLL モジュールをマップするために AfxLoadLibrary を使用します。
アプリケーションが複数のスレッドを使用する場合 AfxFreeLibrary と AfxLoadLibrary を使用してください (Win32 関数の FreeLibrary と LoadLibraryは機能します)。 AfxLoadLibrary と AfxFreeLibrary を使用することによって、拡張 DLL の読み込みまたはアンロード時に実行されるスタートアップ コードと終了コードが、グローバルな MFC の状態を破損するのを防ぎます。
使用例
AfxLoadLibrary"の例を参照してください。
必要条件
ヘッダー: afxdll_.h