在基于MFC的组件程序中加入自卸载功能

发表于:2007-07-14来源:作者:点击数: 标签:
作者:Alexei Evdokimov译自:CodeGuru 使用MFC实现COM组件时,经常节省许多 开发 时间。例如,使用AppWizard生成的基于MFC的COM dll工程,已经自动的提供了DllRegisterServer功能的实现。然而,却没有自动生成DllUnregisterServer功能。一般情况下,DllUnre
作者:Alexei Evdokimov  译自:CodeGuru

使用MFC实现COM组件时,经常节省许多开发时间。例如,使用AppWizard生成的基于MFC的COM dll工程,已经自动的提供了DllRegisterServer功能的实现。然而,却没有自动生成DllUnregisterServer功能。一般情况下,DllUnregisterServer对于程序是不可缺少的,因为一个完整的程序,不仅需要自注册功能,同时也需要自卸载功能。

基于MFC实现DllRegisterServer()的方法是调用COleObjectFactory::UpdateRegistryAll()。这个方法有一个未公开的参数-(BOOL bRegister = TRUE) - 因此,我们猜测通过调用COleObjectFactory::UpdateRegistry(FALSE)将能够实卸载COM dll的功能。但是,事实并非如此。通过分析源代码,我们能够知道COleObjectFactory::UpdateRegistryAll(BOOL bRegister)通过同样的BOOL值调用COleObjectFactory::UpdateRegistry(BOOL bRegister),但是COleObjectFactory::UpdateRegistry(BOOL bRegister)的实现调用UpdateRegistry(LPCTSTR lpszProgID)函数,这个调用仅当bRegister为TRUE时注册组件,否则什么都不做!

所以,有必要写我们自己的DllUnregisterServer()。下面的代码能够实现基于MFC的DllUnregisterServer(),并且使用非常的简单。使用方法:

- 创建文件DllUnregisterServer_MFC_Impl.inl

- 把下面的代码拷贝/粘贴到新建的文件中

- 在dll的主文件.cpp中(dll_name.cpp)加入:


#include "DllUnregisterServer_MFC_Impl.inl"

- 在dll_name.def文件的EXPORTS片断中加入:


DllUnregisterServer PRIVATE

完成!现在你可以使用"regsvr32 /u dll_name.dll"完成组件的卸载了。

以下代码测试环境为VC++ 5.0, VC++ 5.0 SP3, VC++ 6.0,ANSI环境。也可用于UNICODE环境。


//**************************************************************************
// Date : 11.15.98
// Header : DllUnregisterServer_MFC_Impl.inl
//
// Desc.:   DllUnregisterServer() helper for the inproc servers that were
//      registered via MFC’s COleObjectFactory::UpdateRegistryAll()
//
// Usage:
//         Add ’#include "DllUnregisterServer_MFC_Impl.inl"’ to the end of
//      the main dll file (i.e. dll_name.cpp).
//
//         Add ’DllUnregisterServer   PRIVATE’ to EXPORTS section of the
//      dll_name.def.
//
// Caution:
//         Code below uses undocumented, internal MFC data structures
//      and functions. Therefore, probably, it will be necessary to modify
//      it, aclearcase/" target="_blank" >ccording to the changes in the future versions of MFC.
//         Code below is based on the COleObjectFactory::UpdateRegistryAll(),
//      in srcolefact.cpp. (srcolereg.cpp - is actual implementation of
//      all registry work).
//**************************************************************************
#include "stdafx.h"

// workaround MFC bug - no #ifndef/#endif for afximpl.h header
#if !defined(CRIT_OBJECTFACTORYLIST)
#include <..srcafximpl.h>
#endif      //!CRIT_OBJECTFACTORYLIST
//**************************************************************************
static HRESULT UnregisterCOMObject(REFCLSID p_clsid)
{
   LPOLESTR t_wzProgID(NULL);

   // get ProgID from CLSID and unregister...
   HRESULT t_hr = ::ProgIDFromCLSID(p_clsid, &t_wzProgID);
   if(FAILED(t_hr))
      return t_hr;

   // convert OLESTR to LPTSTR
   CString t_strProgID(t_wzProgID);
   LPCTSTR t_szProgID = t_strProgID.operator LPCTSTR();

   // free memory
   ::CoTaskMemFree(t_wzProgID);

   // unregister...
   if(AfxOleUnregisterServerClass(p_clsid,
                   t_szProgID,
                   t_szProgID,
                   t_szProgID,
                   OAT_DISPATCH_OBJECT))
      return S_OK;
   else
      return E_FAIL;
}
//**************************************************************************
// by exporting DllUnregisterServer, you can use regsvr.exe
STDAPI DllUnregisterServer(void)
{
   AFX_MANAGE_STATE(AfxGetStaticModuleState());


   AFX_MODULE_STATE* pModuleState = AfxGetModuleState();

   AfxLockGlobals(CRIT_OBJECTFACTORYLIST);
   for(COleObjectFactory* pFactory = pModuleState->m_factoryList;
      pFactory != NULL;
      pFactory = pFactory->m_pNextFactory)
   {
      HRESULT t_hr = UnregisterCOMObject(pFactory->GetClassID());
      if(FAILED(t_hr))
      {
         AfxUnlockGlobals(CRIT_OBJECTFACTORYLIST);
         return t_hr;
      }
   }
   AfxUnlockGlobals(CRIT_OBJECTFACTORYLIST);

#ifdef _AFXDLL
   AfxLockGlobals(CRIT_DYNLINKLIST);
   // register extension DLL factories
   for(CDynLinkLibrary* pDLL = pModuleState->m_libraryList;
      pDLL != NULL;
      pDLL = pDLL->m_pNextDLL)
   {
      for(pFactory = pDLL->m_factoryList;
         pFactory != NULL;
         pFactory = pFactory->m_pNextFactory)
      {
         HRESULT t_hr = UnregisterCOMObject(pFactory->GetClassID());
         if(FAILED(t_hr))
         {
            AfxUnlockGlobals(CRIT_DYNLINKLIST);
            return t_hr;
         }
      }
   }
   AfxUnlockGlobals(CRIT_DYNLINKLIST);
#endif

   return S_OK;
}
//**************************************************************************
// end of DllUnregisterServer_MFC_Impl.inl 

原文转自:http://www.ltesting.net