DisableThreadLibraryCalls函數用於使指定DLL的
DLL_THREAD_ATTACH和DLL_THREAD_DETACH通知無效,這可減少某些應用程式的工作集空間。原型如下:
BOOL WINAPI DisableThreadLibraryCalls(
__in HMODULE hModule
);
參數hModule是指定DLL模組的控制代碼,可以使用LoadLibrary()、LoadLibraryEx()或GetModuleHandle()函數獲得該控制代碼。當然在DLL中,我們不能調用GetModuleHandle(NULL)來擷取DLL模組的控制代碼,因為這樣獲得的是當前使用該DLL的可執行程式映像的基地址,而不是DLL映像的。
函數調用成功時返回非零值。當指定的DLL模組擁有活動的靜態線程局部儲存或者hModule參數無效時,函數調用失敗。
對於一個擁有很多DLL的多線程應用程式而已,如果這些DLL頻繁地建立和銷毀線程,而且這些DLL不需要線程建立和銷毀通知,則在DLL中使用DisableThreadLibraryCalls函數將能夠起到最佳化應用程式的作用,遠端程序呼叫RPC伺服器就是這樣的例子。在這類應用程式中,如果不使用該函數,DLL初始化常式將駐留在記憶體中以響應DLL_THREAD_ATTACH和DLL_THREAD_DETACH通知。因此,使這兩個通知無效,則DLL初始化代碼就不會因為線程的建立和銷毀而駐留在實體記憶體中了,這就減少了應用程式工作代碼集的大小。一般實現這個最佳化就是在DLL的DLL_PROCESS_ATTACH代碼響應中添加DisableThreadLibraryCalls函數。
有一點需要注意的是,對於靜態連結到C執行階段程式庫(CRT)的DLL我們不應該使用該函數,因為CRT需要DLL_THREAD_ATTACH和DLL_THREAD_DETACH通知才能正確地運行。
下面是程式碼範例:(摘自金山衛士開源作品之ARP防火牆)
HINSTANCE g_hModule = NULL;<br />//////////////////////////////////////////////////////////////////////////</p><p>BOOL WINAPI DllMain(<br />__in HANDLE hInstance,<br />__in DWORD dwReason,<br />__in_opt LPVOID lpReserved<br />)<br />{<br />UNREFERENCED_PARAMETER(lpReserved);</p><p>switch (dwReason)<br />{<br />case DLL_PROCESS_ATTACH:<br />DisableThreadLibraryCalls((HMODULE)hInstance);<br />g_hModule = (HINSTANCE)hInstance;<br />break;<br />case DLL_PROCESS_DETACH:<br />break;<br />default:<br />break;<br />}</p><p>return TRUE;<br />}