PRB: When to Call AfxDaoTerm() in an Automation Server
Article ID: 152315
Article Last Modified on 11/21/2006
APPLIES TO
- Microsoft Foundation Class Library 4.2, when used with:
- Microsoft Visual C++ 4.0 Standard Edition
- Microsoft Visual C++ 4.1 Subscription
- Microsoft Visual C++ 4.2 Enterprise Edition
- Microsoft Visual C++ 4.2 Professional Edition
- Microsoft Visual C++ 4.2 Enterprise Edition
- Microsoft Visual C++ 4.2 Professional Edition
- Microsoft Visual C++ 5.0 Enterprise Edition
- Microsoft Visual C++ 5.0 Professional Edition
This article was previously published under Q152315
SYMPTOMS
MFC DLLs and OCXs that use DAO need to call AfxDaoTerm() to terminate DAO
before their ExitInstance() function is called. MFC, by default, calls
AfxDaoTerm() from within CWinApp::ExitInstance().
An automation server may expose multiple objects that use DAO. Calling
AfxDaoTerm() when one of these objects is destructed may have the undesired
effect of terminating DAO for all other objects that may still be in use.
RESOLUTION
MFC keeps an internal object lock count of automation objects in the module
state. The constructor of each object exposed by the automation server
calls AfxOleLockApp() to increment this count and calls AfxOleUnlockApp()
to decrement it.
An MFC DLL automation server gets unloaded when the AfxOleCanExitApp()
function returns TRUE. This function checks the object lock count and
returns TRUE if no objects are in use. The default implementation of
DllCanUnloadNow() in an AppWizard-generated automation server looks like
this:
STDAPI DllCanUnloadNow(void)
{
AFX_MANAGE_STATE(AfxGetStaticModuleState());
return AfxDllCanUnloadNow();
}
Add the following code to terminate DAO when no automation objects are
in use any longer:
STDAPI DllCanUnloadNow(void)
{
AFX_MANAGE_STATE(AfxGetStaticModuleState());
if (AfxOleCanExitApp())
AfxDaoTerm();
return AfxDllCanUnloadNow();
}
STATUS
This behavior is by design.
REFERENCES
For more information, please refer to the following articles in the
Microsoft Knowledge Base:
143084 FIX: Problems with Using the MFC DAO Classes in a .DLL or .OCX
149889 PRB: Assertion or Problems Using DAO in a DLL
Keywords: kbdatabase kbprogramming kbprb KB152315