PRB: Assertion or Problems Using DAO in a DLL

• The Microsoft Foundation Classes (MFC) included with: - Microsoft Visual C++, 32-bit Edition, versions 4.0, 4.1, 4.1b, 4.2,

       4.2b, 5.0
  

SYMPTOMS

This article provides some guidelines for using DAO in regular DLLs. In general, avoid performing any DAO construction, destruction, or operations inside the DLL's InitInstance or ExitInstance functions. Otherwise, you might see the following assertions:

   Assertion failed in DAOCORE.CPP, line 36  (in Visual C++ 4.0)
   Assertion failed in APPCORE.CPP, line 585 (in Visual C++ 4.1)

WORKAROUND

All MFC/DAO objects in the DLL must be destroyed before the call to AfxDaoTerm. Be careful about the scope of local and global DAO objects. For example, the following code causes an assert:

   SomeExportedFunc( .. )
   {
      // Only call for regular MFC DLL's
      #ifndef _AFXDLL
      AFX_MANAGE_STATE(AfxGetStaticModuleState());
      #endif

      CDaoDatabase db;
      db.Open(..);
      db.Close();
      AfxDaoTerm();
   }

To ensure that your MFC/DAO objects are destroyed before calling AfxDaoTerm, avoid global objects and create local objects dynamically by using the new operator as in this example:

   SomeExportedFunc( .. )
   {
      // Only call for regular MFC DLL's
      #ifndef _AFXDLL
      AFX_MANAGE_STATE(AfxGetStaticModuleState());
      #endif

      CDaoDatabase *DB = new CDaoDatabase;
      pDB->Open(..);

      // do something

      pDB->Close();

      // Destroy the object with delete
      delete pDB;

      // can now safely terminate DAO
      AfxDaoTerm();
   }

   SomeExportedInitializeDAO( .. )
   {
      // Only call for regular MFC DLL's
      #ifndef _AFXDLL
      AFX_MANAGE_STATE(AfxGetStaticModuleState());
      #endif

      m_pDB = new CDaoDatabase;
      m_pDB->Open(..);
   }

   SomeExportedDestroyObjectsAndTerminateDAO( .. )
   {
      // Only call for regular MFC DLL's
      #ifndef _AFXDLL
      AFX_MANAGE_STATE(AfxGetStaticModuleState());
      #endif

     m_pDB->Close();
     delete m_pDB;
     AfxDaoTerm();
   }

STATUS

This behavior is by design. MFC/DAO objects need to be created after CWinApp::InitInstance and destroyed before terminating DAO. By default, MFC attempts to terminate DAO within CWinApp::ExitInstance.

MORE INFORMATION

The AfxDaoTerm helper function terminates the DAO database engine. In applications, AfxDaoTerm is called automatically, but in DLLs, it must be explicitly invoked before the DLL's ExitInstance function.

Here are some general guidelines to follow:

• Create any MFC/DAO objects after the DLL's InitInstance function. For additional information, please see the following article in the Microsoft Knowledge Base:

  ARTICLE-ID: Q147629

     TITLE     : PRB: Problems If ODBC or DAO in DLL's InitInstance or
                 DLLMain
  
  

• Destroy these objects before calling AfxDaoTerm.
• Call AfxDaoTerm before calling the DLL's ExitInstance function.

AfxDaoInit

This function initializes the DAO database engine. In most cases, you don't need to call AfxDaoInit because the application calls it when it is needed. AfxDaoInit is called during the construction of the first MFC/DAO object.

AfxDaoTerm

This function terminates the DAO database engine. Typically, this function only needs to be called in a DLL; an application automatically calls AfxDaTerm when it is needed.

When DAO is initialized, MFC will set the m_lpfnDaoTerm pointer in the CWinApp class to point to AfxDaoTerm(). When CWinApp::ExitInstance is invoked, by default it invokes the value of m_lpfnDaoTerm if it is set.

In a Regular DLL, you need to call AfxDaoTerm() before the default ExitInstance is invoked because ExitInstance is invoked by DllMain. Visual C++ 4.0 had a documented bug where the .exe's ExitInstance would shut down DAO, causing an assertion when the Regular DLL's ExitInstance was called.

For additional information, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q143084
   TITLE     : FIX: Problems with Using the MFC DAO Classes in a .DLL or
              .OCX

REFERENCES

For related information, see Technical Note 54. Technical Notes are available under MFC Technical Notes, under MFC Books Online.

For additional information on how to use AFX_MANAGE_STATE correctly, please see MFC Technical Note 58 (TN058) and the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q140850
   TITLE     : How to Convert DLLTRACE to Use MFC in Shared Library

Keywords          : MfcDAO kbprg
Technology        : kbMfc
Version           : WINDOWS NT: 4.0 4.1 4.1b 4.2 4.2b 5.0
Platform          : NT WINDOWS
Issue type        : kbprb