AfxFreeLibrary
更新 : 2007 年 11 月
AfxFreeLibrary と AfxLoadLibrary は、読み込まれた各ライブラリ モジュールの参照カウントを保持します。
BOOL AFXAPI AfxFreeLibrary(
HINSTANCE hInstLib
);
パラメータ
- hInstLib
読み込まれたライブラリ モジュールのハンドル。このハンドルは AfxLoadLibrary によって返されます。
戻り値
正常終了した場合は TRUE を返します。それ以外の場合は FALSE を返します。
解説
AfxFreeLibrary は、読み込まれたダイナミック リンク ライブラリ (DLL) モジュールの参照カウントをデクリメントします。参照カウントが 0 になると、モジュールが呼び出しプロセスのアドレス領域から解放され、ハンドルが無効になります。この参照カウントは、AfxLoadLibrary が呼び出されるたびにインクリメントされます。
ライブラリ モジュールを解放する前に、システムは、DLL を使用しているプロセスから DLL を接続解除できるようにします。これにより、DLL が現在のプロセスに割り当てていたリソースを解放できるようにします。エントリ ポイント関数から返った時点で、ライブラリ モジュールは現在のプロセスのアドレス領域から解放されています。
DLL モジュールを割り当てるには、AfxLoadLibrary を使用します。
アプリケーションでマルチスレッドを使用する場合、Win32 関数 FreeLibrary と LoadLibrary の代わりに、AfxFreeLibrary と AfxLoadLibrary を使用してください。AfxLoadLibrary と AfxFreeLibrary を使用することによって、拡張 DLL の読み込みまたはアンロード時に実行されるスタートアップ コードと終了コードが、グローバルな MFC の状態を破損するのを防ぎます。
使用例
「AfxLoadLibrary」の例を参照してください。
必要条件
ヘッダー : afxdll_.h