PRB: Error Message Box Returned When DLL Load Fails

• Microsoft Win32 Application Programming Interface (API) included with:

      - Microsoft Windows NT versions 3.5, 3.51, and 4.00
      - Microsoft Windows 95 version 4.0
  

SYMPTOMS

Under Windows NT, when you load a DLL, a message box titled "Invalid DLL Entrypoint" is displayed and has the following text:

   The dynamic link library <name> is not written correctly.
   The stack pointer has been left in an inconsistent state.
   The entry point should be declared as WINAPI or STDCALL.
   Select YES to fail the DLL load. Select NO to continue
   execution. Selecting NO may cause the application to operate
   incorrectly.

   The <dll file name> file cannot start. Check the file to
   determine the problem.

CAUSE

The system expects DLL entrypoints to use the _stdcall convention. If you use the _cdecl convention, the stack is not properly restored and subsequent calls into the DLL can cause a general protection fault (GPF).

This error message is new to Windows NT, version 3.5. Under Windows NT, version 3.1, the DLL is loaded without an error message, but the application usually causes a GPF when calling a DLL routine.

RESOLUTION

Correct the prototype of your entrypoint. For example, if your entrypoint is as follows:

   BOOL DllMain( HANDLE hDLL, DWORD dwReason, LPVOID lpReserved)

   BOOL WINAPI DllMain( HANDLE hDLL, DWORD dwReason, LPVOID lpReserved)

   -entry:_DllMainCRTStartup$(DLLENTRY)

MORE INFORMATION

If you are using the Microsoft C run-time, you need to use the entry point given in the RESOLUTION section in order to properly initialize the C run- time. For additional information, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q94248
   TITLE     : Using the C Run Time

REFERENCES

For more information on the DLL entrypoint, please search on the topic "DllEntryPoint" (without the quotes) in the Win32 API help file.