DisableThreadLibraryCalls

指定された DLL に対する DLL_THREAD_ATTACH および DLL_THREAD_DETACH 通知を無効にする。

DisableThreadLibraryCalls hLibModule

hLibModule : [intptr] DLL_THREAD_ATTACH および DLL_THREAD_DETACH 通知を無効にする DLL モジュールへのハンドル。LoadLibrary、LoadLibraryEx、または GetModuleHandle 関数がこのハンドルを返す。NULL を指定して GetModuleHandle を呼び出すことはできない。これは DLL イメージではなく実行可能イメージのベースアドレスを返すためである。

(プラグイン / モジュール : kernel32.dll)

解説

指定された DLL に対する DLL_THREAD_ATTACH および DLL_THREAD_DETACH 通知を無効にする。

[戻り値]
関数が成功した場合、戻り値は 0 以外である。関数が失敗した場合、戻り値は 0 となる。hModule で指定された DLL
がアクティブな静的スレッドローカルストレージを持っている場合、または hModule
が無効なモジュールハンドルである場合、DisableThreadLibraryCalls 関数は失敗する。拡張エラー情報を取得するには
GetLastError を呼ぶ。

[備考]
DisableThreadLibraryCalls 関数を使うと、DLL は DLL_THREAD_ATTACH と
DLL_THREAD_DETACH 通知呼び出しを無効化できる。これは多くの DLL を持ち、頻繁にスレッドを作成・削除し、それらの
DLL がスレッドレベルのアタッチ/デタッチ通知を必要としないマルチスレッドアプリケーションにとって有用な最適化となる。RPC
サーバーアプリケーションがそのような例である。この種のアプリケーションでは、DLL の初期化ルーチンが DLL_THREAD_ATTACH
と DLL_THREAD_DETACH
通知に応答するためにメモリ上に残っていることが多い。通知を無効化することで、スレッドの作成や削除によって DLL
初期化コードがページインされなくなり、アプリケーションのワーキングコードセットのサイズを削減できる。最適化を実装するには、DLL の
DLL_PROCESS_ATTACH コードを変更して DisableThreadLibraryCalls を呼び出す。静的 C
ランタイムライブラリ (CRT) にリンクされた DLL からこの関数を呼び出してはならない。静的 CRT が正しく機能するためには
DLL_THREAD_ATTACH と DLL_THREAD_DETATCH 通知が必要である。静的 [Thread Local
Storage (TLS)](/windows/win32/procthread/thread-local-storage)
が有効な場合、この関数は何の最適化も行わない。静的 TLS は **thread_local** 変数、**__declspec(
thread )** 変数、または関数ローカルな **static** を使用するときに有効になる。

情報