MFC，欢乐与痛苦

MFC提供了许多十分有用的类和对象，在很多时候在Office插件、BHO、常规DLL这样的工程中加入MFC支持是一个不错的选择。但是，MFC中的很多功能，例如资源查找，消息预处理等等都依赖于在进程或者线程创建时被初始化的MFC内部数据；而对于需要添加MFC支持的工程，这些数据并不会被自动地初始化。这时候使用一些MFC的功能，例如使用CString从字符串表加载一个字符串，或者使用CDialog::DoModal()创建一个模态对话框，都会有断言错误，用ATL向导创建的支持MFC的程序也没有多少改善，在CWinApp的DLL版本中没有初始化线程数据，所以调用AfxGetThread会返回空指针。解决这个问题的一个办法是使用AfxBeginThread来启动一个MFC线程，这样MFC会初始化线程相关的数据。在下面的示例中，我在线程初始化时建立了一个模态对话框，以避免直接创建模态对话框会触发的断言失败信息。为了模拟模态对话框的效果，在CDialogThread::WaitForDoModal()这个函数中创建了一个消息循环来等待线程结束，同时用MsgWaitForMultipleObjects来避免死锁。因为MFC中和进程相关的数据并不总是被正确初始化，在调用模态对话框之前也需要手动设置一下。

//如果这段代码可以工作，那么它的作者是Jiangsheng
//否则我不知道它的作者
void __stdcall CFrontPageAddin::OnClickButtonExportCHM(IDispatch* /*Office::_CommandBarButton*
*/ Ctrl,VARIANT_BOOL * CancelDefault)
{
AtlTrace(_T(" CFPAnt::OnClickButtonExportCHM\n"));
//create a thread to avoid assert failure
CDialogThread* pDialogThread=
(CDialogThread*)AfxBeginThread(RUNTIME_CLASS(CDialogThread),
THREAD_PRIORITY_NORMAL,
0,
CREATE_SUSPENDED,NULL);
if(pDialogThread)
{
pDialogThread->m_prc=RUNTIME_CLASS(CExportCHMSheet);
pDialogThread->ResumeThread();
pDialogThread->WaitForDoModal();
delete pDialogThread;
}
}
class CDialogThread : public CWinThread
{
......
int m_nModalResult;
CRuntimeClass* m_prc;
void WaitForDoModal();
......
};
CDialogThread::CDialogThread()
{
m_bAutoDelete=FALSE;
m_prc=NULL;
m_nModalResult=0;
}
BOOL CDialogThread::InitInstance()
{
// TODO: perform and per-thread initialization here
AFX_MANAGE_STATE(AfxGetAppModuleState());
AFX_MODULE_STATE* pModuleState=AfxGetModuleState();
pModuleState->m_hCurrentInstanceHandle=_Module.GetModuleInstance();
AfxSetResourceHandle(_Module.GetModuleInstance());
if(m_prc)
{
if(m_prc->IsDerivedFrom(RUNTIME_CLASS(CDialog)))
{
CDialog* pDialog=(CDialog*)m_prc->CreateObject();
if(pDialog)
{
m_pMainWnd=pDialog;
m_nModalResult=pDialog->DoModal();
}
}
else if(m_prc->IsDerivedFrom(RUNTIME_CLASS(CPropertySheet)))
{
CPropertySheet* pDialog=(CPropertySheet*)m_prc->CreateObject();
if(pDialog)
{
m_pMainWnd=pDialog;
m_nModalResult=pDialog->DoModal();
}
}
}
return FALSE;
}
void CDialogThread::WaitForDoModal()
{
//from http://blogs.msdn.com/oldnewthing/archive/2005/02/17/375307.aspx
MSG msg;
UINT cRecords = 0;
while (true) {
switch (MsgWaitForMultipleObjects(1, &m_hThread,
FALSE, INFINITE, QS_ALLINPUT)) {
case WAIT_OBJECT_0:
return ; // event has been signalled
break;
case WAIT_OBJECT_0+1:
// we have a message - peek and dispatch it
if (PeekMessage(&msg, NULL, 0, 0, PM_REMOVE)) {
TranslateMessage(&msg);
DispatchMessage(&msg);
}
break;
default:
return ; // unexpected failure
}
}
}


使用VC6.0编译通过。

上面的方法只对于DLL之类的组件比较有用。对于使用MFC的应用程序来说，上面的方法比较繁琐。比较简单的方法还是使用MFC向导来创建应用程序，然后再添加ATL或者.Net之类的额外支持。参考微软知识库文章Q181505和Q824480。
参考

BUG: You receive an "ASSERT in wincore.cpp" assert when an MFC application calls a function in MFC regular DLL in Visual C++（http://support.microsoft.com/kb/194300）
PRB: ATL COM AppWizard Doesn't Offer MFC Support for .EXE（http://support.microsoft.com/kb/181505）
PRB：为 C++ DLL 项目建立托管扩展时出现链接器警告（http://support.microsoft.com/kb/814472）
BUG: "HRESULT - 0x80010106" Error When You Run a Managed C++ Application（http://support.microsoft.com/kb/824480）

Hook DHTML Commands

Hook DHTML Commands

浏览器在执行很多命令之前都会允许容器来替换默认的处理。在执行一些默认的命令之前，系统会查询用户对IDocHostUIHandler的实现对象的IOleCommandTarget接口，调用默认(NULL)或者CGID_DocHostCommandHandler命令组的命令。如果容器的对应命令处理返回S_OK。那么默认的处理就不会被调用。

下面列出一些可以在容器中自定义的操作：（这些常量的定义位于docobj.h中）

• OLECMDID_PRINT，默认命令组
  
• OLECMDID_SHOWSCRIPTERROR, CGID_DocHostCommandHandler命令组
  
• OLECMDID_FOCUSVIEWCONTROLSQUERY, CGID_DocHostCommandHandler命令组
  
• OLECMDID_SHOWPAGEACTIONMENU, CGID_DocHostCommandHandler命令组

MFC提供了一些比较容易扩展的类和宏，这样可以很容易地在扩展容器来实现新的接口。这里使用CCmdTarget类提供的GetInterfaceHook虚函数来进行扩展。

//This sample is based on MFC sample DHTMLExplore.<br />//a button is inserted into explore.htm:<br />//<BUTTON class=hotElement id=print accesskey="P"><U>P</U>rint</BUTTON><br />//to invoke the print command<br /><br />#include <afxole.h><br />#include <mshtmcid.h><br />/////////////////////////////////////////////////////////////////////////////<br />// CDHtmlExploreDlg dialog<br />class CDHtmlExploreDlg;<br />//customize the CBrowserControlSite class to implement IOleCommandTarget.<br />//the IDocHostUIHandler interface is implemented in CBrowserControlSite, <br />//an internal control site class declared within afxdhtml.h<br />class CDHtmlExploreControlSite: public CBrowserControlSite<br /> , public IOleCommandTarget<br /> CDHtmlExploreControlSite(<br /> COleControlContainer* pCtrlCont,<br /> CDHtmlExploreDlg *pHandler) <br /> : CBrowserControlSite(pCtrlCont,pHandler){};<br />protected:<br />// Implementation<br /> LPUNKNOWN GetInterfaceHook(const void *iid);<br />// IUnknown methods<br />...//omitted<br />// IOleCommandTargetmethods <br />...//omitted<br /> friend class CDHtmlExploreDlg;<br />};<br />class CDHtmlExploreDlg : public CDHtmlDialog<br />{<br />......<br /> virtual BOOL CreateControlSite(COleControlContainer* pContainer, <br />COleControlSite** ppSite, UINT /* nID */, REFCLSID /* clsid */);<br /> HRESULT OnPrint(IHTMLElement *phtmlElement);<br />// IOleCommandTargetmethods <br />...//omitted<br />......<br /> afx_msg void OnContextPrint();<br />......<br /> friend class CDHtmlExploreControlSite ;<br />};<br />LPUNKNOWN CDHtmlExploreControlSite::GetInterfaceHook(const void *iid)<br />{<br /> if (IsEqualIID((REFIID) (*(IID*)iid), IID_IOleCommandTarget))<br /> return (IOleCommandTarget*) this;<br /> //important ,base class implementation <br /> //customized GetInterfaceHook to support IDocHostUIHandler<br /> return CBrowserControlSite::GetInterfaceHook(iid); <br />}<br />// IUnknown methods<br />STDMETHODIMP CDHtmlExploreControlSite::QueryInterface(REFIID riid, void **ppvObject)<br />{<br /> return COleControlSite::ExternalQueryInterface(&riid, ppvObject);<br />}<br />STDMETHODIMP_(ULONG) CDHtmlExploreControlSite::AddRef()<br />{<br /> return ExternalAddRef();<br />}<br /><br />STDMETHODIMP_(ULONG) CDHtmlExploreControlSite::Release()<br />{<br /> return ExternalRelease();<br />}<br />// redirect IOleCommandTarget calls<br />STDMETHODIMP CDHtmlExploreControlSite::QueryStatus(const GUID *pguidCmdGroup,<br /> ULONG cCmds,<br /> OLECMD prgCmds[ ],<br /> OLECMDTEXT *pCmdText)<br />{<br /> return reinterpret_cast<CDHtmlExploreDlg*>(m_pHandler)->QueryStatus(<br /> pguidCmdGroup,<br /> cCmds,<br /> prgCmds,<br /> pCmdText);<br />}<br />STDMETHODIMP CDHtmlExploreControlSite::Exec(const GUID *pguidCmdGroup,<br /> DWORD nCmdID,<br /> DWORD nCmdexecopt,<br /> VARIANT *pvaIn,<br /> VARIANT *pvaOut)<br />{<br /> return reinterpret_cast<CDHtmlExploreDlg*>(m_pHandler)->Exec(<br /> pguidCmdGroup,<br /> nCmdID,<br /> nCmdexecopt,<br /> pvaIn,<br /> pvaOut);<br />}<br />//replace the control site to support IOleCommandTarget<br />BOOL CDHtmlExploreDlg::CreateControlSite(COleControlContainer* pContainer, <br />COleControlSite** ppSite, UINT /* nID */, REFCLSID /* clsid */)<br />{<br /> if(ppSite == NULL)<br /> {<br /> ASSERT(FALSE);<br /> return FALSE;<br /> }<br /><br /> CDHtmlExploreControlSite *pBrowserSite = <br /> new CDHtmlExploreControlSite(pContainer, this);<br /> if (!pBrowserSite)<br /> return FALSE;<br /> *ppSite = pBrowserSite;<br /> return TRUE;<br />}<br />.....<br />ON_COMMAND(ID_CONTEXT_PRINT, OnContextPrint) //message map<br />.....<br />DHTML_EVENT_ONCLICK(_T("print"), OnPrint)//DHTML event map<br />void CDHtmlExploreDlg::OnContextPrintPreview() <br />{<br /> // TODO: Add your command handler code here<br /> OnPrintPreview(NULL);<br />}<br />//for more information about <br />HRESULT CDHtmlExploreDlg::OnPrint(IHTMLElement* /*phtmlElement*/)<br />{<br /> CComQIPtr<IOleCommandTarget> poctBrowserApp(m_pBrowserApp);<br /> if(poctBrowserApp==NULL)return E_FAIL;<br /> return poctBrowserApp->Exec<br /> (&CGID_MSHTML,IDM_PRINT,OLECMDEXECOPT_PROMPTUSER,NULL,NULL);<br />}<br />//dump information about commands <br />//and ignore the print command<br />STDMETHODIMP CDHtmlExploreDlg::QueryStatus(const GUID *pguidCmdGroup,<br /> ULONG cCmds,<br /> OLECMD prgCmds[ ],<br /> OLECMDTEXT *pCmdText)<br />{<br /> CString strTrace(_T("QueryStatus:Command Group:"));<br /> CStringW strCommandGroup(_T("NULL"));<br /> CString strCommand;<br /> CString strCommands;<br /> if(pguidCmdGroup)<br /> {<br /> LPOLESTR pwstrCommandGroup=NULL;<br /> ::StringFromCLSID (*pguidCmdGroup,&pwstrCommandGroup);<br /> if(pwstrCommandGroup)<br /> {<br /> strCommandGroup=pwstrCommandGroup;<br /> CoTaskMemFree(pwstrCommandGroup);<br /> } <br /> }<br /> strTrace+=strCommandGroup;<br /><br /> for(UINT i=0;i<cCmds;i++)<br /> {<br /> strCommand.Format(_T("%x"),prgCmds[i].cmdID);<br /> strCommands+=",";<br /> strCommands+=strCommand;<br /> }<br /> strTrace+=strCommands;<br /> strTrace+=_T("\r\n");<br /> TRACE(strTrace);<br /> return E_NOTIMPL;<br />}<br />STDMETHODIMP CDHtmlExploreDlg::Exec(const GUID *pguidCmdGroup,<br /> DWORD nCmdID,<br /> DWORD nCmdexecopt,<br /> VARIANT *pvaIn,<br /> VARIANT *pvaOut)<br />{<br /> CString strTrace(_T("Exec:Command Group:"));<br /> CStringW strCommandGroup(_T("NULL"));<br /> CString strCommand;<br /> if(pguidCmdGroup)<br /> {<br /> LPOLESTR pwstrCommandGroup=NULL;<br /> ::StringFromCLSID (*pguidCmdGroup,&pwstrCommandGroup);<br /> if(pwstrCommandGroup)<br /> {<br /> strCommandGroup=pwstrCommandGroup;<br /> CoTaskMemFree(pwstrCommandGroup);<br /> } <br /> }<br /> strTrace+=strCommandGroup;<br /> strCommand.Format(_T("%x"),nCmdID);<br /> strTrace+=",";<br /> strTrace+=strCommand;<br /> strTrace+=_T("\r\n");<br /> TRACE(strTrace);<br /> if (pguidCmdGroup&&IsEqualIID((REFIID) (*(IID*)pguidCmdGroup)<br /> ,CGID_DocHostCommandHandler))<br /> {<br /> switch(nCmdID)<br /> {<br /> case OLECMDID_PRINT:<br /> return S_OK; //ignore it<br /> }<br /> }<br /> return E_NOTIMPL;<br />}<br />

浏览器控件访问容器的方式是查询容器的IDocHostUIHandler接口，而对于浏览器辅助对象(Browser Helper Object/ BHO)，不能修改容器来增加一个新的接口。这时候可以通过HTML文档的ICustomDoc接口来设置自己的IDocHostUIHandler接口。

class ATL_NO_VTABLE CBHO : <br /> public IObjectWithSiteImpl<CBHO>,<br /> public IDispatchImpl<IBHOb, &__uuidof(IBHO)>,<br /> public IDocHostUIHandler,<br /> public IOleCommandTarget<br /> case DISPID_DOCUMENTCOMPLETE:<br /> ATLTRACE(_T("(%ld) DISPID_DOCUMENTCOMPLETE\n"), ::GetCurrentThreadId());<br /> //if the page is done downloading<br /> if (m_pWBDisp && <br /> m_pWBDisp == pDispParams->rgvarg[1].pdispVal)<br /> {<br /> ......<br /> CComPtr<IDispatch> spDisp;<br /> HRESULT hr = m_spWebBrowser2->get_Document(&spDisp);<br /> ......<br /> // replace the IDocHostUIHandler<br /> CComQIPtr<ICustomDoc, &IID_ICustomDoc> spCustomDoc(spDisp);<br /> if (spCustomDoc)<br /> spCustomDoc->SetUIHandler(this);<br /> .....<br /> }<br />

在捕获容器的命令的过程中发现一些其他命令也被发送到容器（按时间顺序）：

行为	命令组	命令
加载	NULL	OLECMDID_SETDOWNLOADSTATE
	000214D0-0000-0000-C000-000000000046	OLECMDID_PASTESPECIAL/ OLECMDID_HIDETOOLBARS / OLECMDID_PREREFRESH/ OLECMDID_ONUNLOAD
	NULL	OLECMDID_SETPROGRESSMAX/ OLECMDID_SETPROGRESSPOS/ OLECMDID_SETDOWNLOADSTATE
打印	CGID_DocHostCommandHandler	OLECMDID_PRINT
刷新	CGID_DocHostCommandHandler	0x1799
	NULL	OLECMDID_PREREFRESH/ OLECMDID_SETPROGRESSMAX/ OLECMDID_SETPROGRESSPOS/ OLECMDID_SETDOWNLOADSTATE
	000214D0-0000-0000-C000-000000000046	OLECMDID_ONUNLOAD/ OLECMDID_PREREFRESH

不是所有常用操作都会转发到容器。OLECMDID_PRINTPREVIEW、OLECMDID_SAVEAS、OLECMDID_REFRESH看起来就没有被转发。

参考文档：

• MSDN文章 MFC技术文档TN038 MFC/OLE IUnknown Implementation (http://msdn.microsoft.com/library/en-us/vclib/html/_mfcnotes_tn038.asp)
  
• 微软知识库文章 Q261003 How to handle script errors as a WebBrowser control host (http://support.microsoft.com/kb/261003)
  
• 微软知识库文章 Q317024 Script error notification is not sent to Exec method of WebBrowser Host(http://support.microsoft.com/kb/317024)
  
• MSDN文章 WebBrowser Customization (http://msdn.microsoft.com/workshop/browser/hosting/wbcustomization.asp)
  
• 微软知识库文章 Q267240 How to print custom headers and footers for a WebBrowser control in Internet Explorer (http://support.microsoft.com/kb/267240)

Visual Studio 2005 June CTP的资源编辑器似乎有点问题，改过资源就保存不到原文件了，只能保存到另一个文件，关闭Visual Stuio之后替换(关闭solution都不行)。

Visual Studio 2005中MFC的变化

关于新功能的说明http://msdn2.microsoft.com/library/y8bt6w34(en-us,vs.80).aspx

一些源代码的变化：

对CLR、.Net类库和Winform控件的支持。
多处安全性的增强，对于函数参数和消息影射类型的检查加强。对ISAPI的支持看起来改动很大。
对基于64位处理器的软件开发的支持。
一些过时功能，例如MFC的DAO类，的使用受到限制。对于64位开发环境，MFC的DAO类是被禁用的。
OLE控件容器和激活状态的改进
新增加的ENSURE宏在ASSERT之外还可以抛出异常。
修正了一些BUG
VC7引入的对GetHtmlDocument()的引用导致内存泄漏的问题。
CHtmlView::ExecFormsCommand中调用IOleCommandTarget::Exec时参数写反了的问题
把CArchiveException::generic修改为CArchiveException::genericException以避免潜在的关键字冲突（微软看起来又准备引入一个新的关键字）

把WinDbg集成到Visual Studio中

在我的前一篇BLOG(http://blog.joycode.com/jiangsheng/archive/2005/06/08/53126.aspx)中我提到了如何使用WinDbg来调试Visual C++程序。但是，从IDE到命令行之间的切换比较麻烦，为了偷懒起见，可以把WinDbg加到Visual Studio的工具菜单中，这样就可以直接从IDE启动WinDbg来进行调试了。下面是外部工具配置界面的设置
标题 : WinDbg

命令行: C:\masm32\debug\windbg.exe (这不是一个典型路径，但是既然MASM里面有了，我也懒得再去下一个来装，如果是单独下载安装的话，命令行可能像这样："C:\Program Files\Debugging Tools for Windows\windbg.exe")

参数:-ee c++ -G -i "$(TargetDir)" -y "$(TargetDir)" -QY -logo -QSY -sdce -WF "$(ProjectFileName).WEW" "$(TargetPath)"

(命令行太长的时候windbg会工作不正常。至于这些参数的含义——呃，还是去下一个Debug Tools For Windows回来装上看文档比较好。）

初始目录: $(ProjectDir)

当然，调试的代码不限于C++，实际上，我主要是用windbg来调试汇编代码。

使用WinDbg调试VC程序

虽然在VC6.0中可以通过安装Visual C++ Toolkit(网站：http://msdn.microsoft.com/visualc/vctoolkit2003/)来编写基于最新版本的平台SDK、DirectX SDK的程序以及托管代码，但是VC6附带的调试器并不支持新版本的调试信息，所以实际上是不能用VC6来调试新版本编译器生成的程序的。一个替代的解决方案是使用新版本的Windows调试工具Windbg(网站：http://www.microsoft.com/whdc/DevTools/Debugging/default.mspx)。Windbg的调试功能基本和Visual C++中的相同，但是需要手动设定源文件和调试符号文件的搜索路径（可以参考VC6.0中的对应设置）。一些代码，例如MFC的代码比较难于定位，这时可以双击调用堆栈中的函数名称来打开文件并定位到函数所在位置。Windbg可以进行有限的托管代码调试，但是调试过程比较麻烦。在没有安装Visual Studio的计算机上调试，例如进行远程调试的时候可能还需要部署调试符号(Generating and Deploying Debug Symbols With Visual C++ 6.0)。
调试Visual Studio .Net 的程序需要用户是管理员或者"Debug User"用户组成员。如果登录用户不是该组成员，那么也可以用WinDbg来调试程序。