PRB: LoadLibrary() Fails with _declspec(thread)

• Microsoft Win32 Application Programming Interface (API), used with:
  • Microsoft Windows NT versions 3.5, 3.51, 4.0
  • Microsoft Windows 95, version 4.0
  • Microsoft Win32s versions 1.1, 1.15, 1.2, 1.25a

SYMPTOMS

Your dynamic-link library (DLL) uses __declspec(thread) to allocate thread local storage (TLS). There are no problems running an application that is statically linked with the DLL's import library. However, when an application uses LoadLibrary() to load the DLL instead of using the import library, LoadLibrary() fails on Win32s with

error 87: invalid parameter

CAUSE

This is a limitation of LoadLibrary() and __declspec(). The global variable space for a thread is allocated at run time. The size is based on a calculation of the requirements of the application plus the requirements of all of the DLLs that are statically linked. When you use LoadLibrary(), there is no way to extend this space to allow for the thread local variables declared with __declspec(thread). This can cause a protection fault either when the DLL is dynamically loaded or code references the data.

RESOLUTION

DLLs that use __declspec(thread) should not be loaded with LoadLibrary().

Use the Thread Local Storage (TLS) APIs, such as TlsAlloc(), in your DLL to allocate TLS if the DLL might be loaded with LoadLibrary(). If you continue to use _declspec(), warn users of the DLL that they should not load the DLL with LoadLibrary().

Additional query words: 1.10 1.20 3.50

Keywords : kbDLL kbKernBase kbWinOS2000 kbThread kbDSupport kbGrpKernBase
Version : winnt:3.5,3.51,4.0
Platform : winnt
Issue type : kbprb