第2章 AO开发工具

if (FAILED(hr)) return hr; // Explicitly class Release() ipGak = 0 ipBar = 0 // Let destructor call Foo's Release return S_OK; }
在重新指定一个ATL smart指针时，如果前一个接口指针没有释放掉，就会产生一个调 试ASSERT错误。 在这个例子中，我们看到得最多的smart指针时DTC类型。在下面的这个例子中，我们 说明了BSTR和VARIAVT数据类型，并使用了DTC指针。当在使用CComBSTR时，使用文 本映射L””来声明OLECHAR常量字符串。CComVariant直接来源于VARIANT数据类型，这 意味着没有对它的实现进行重载，从而简化了它的使用。它有大量的构造器和函数，这些构 造器和函数可以直接使用VARIANTs；还有一些方法可以从数据流中进行读和写。在重新使 用这个变量之前，确保调用了Clear方法。
ASSERT(wnd && loading); VERIFY(contents->LoadContextMenu()); happens in
// NOP in release build. // LoadContextMenu // release build!
使用 WIN32_ASSERT 任何用来设置错误代码的Win32调用都可以用WIN32_ASSERT来提出一个异常， 并显示 GetLastError（）的结果。然而，这个宏的作用与VERIFY一样，在发布版中仍然存在边缘效 应，所以应该确保这是你需要的行为。 特征字符串 对于你需要对其进行追踪和操纵的字符串数据而言， 开以考虑用Cstring来代替对特征数 组的管理。 因为Cstring是完全基于TCHAR的，所以你可以不用做任何额外的工作就可以很明显 的对 Unicode（同一字符编码标准）进行处理。 Cstring的内存使用效率非常高――在将同样的字符串从一个Cstring传到另一个Cstring 的 过程中，并没有分配新的内存，直到第二个字符串被修改。 应用系统设置 使用Window注册表来存储并获取应用程序的设置。不要使用.ini文件。 Windows 和 MFC 函数调用 对于所有的Windows和全局MFC函数的调用可以使用::来表示全局范围。
唯一的一个例外就是调试字符串――它可能直接放在了代码中， 因为它不会影响发布的 产品，而且不需要使其局部化。 将所有的字符串常量存储在一个标准模块中，以便更容易的将它们转换为其他语言。 支持Unicode（统一字符编码标准） 所有的代码都应该遵循Unicode， 因此， 使用TCHAR的数组来表示特征字符串。 TCHAR 可以扩展为单特征 （single-character） 的字符串 （ANSI） 也可以扩展为多特征 ， （wide-character） 的字符串（Unicode）。 对于字符串文字，可以使用TEXT宏来对字符串或特征进行转化：
Localization 要求 当开发一个供使用的应用系统中使用了不只一种语言的时候， 必须考虑很多问题， 这会 将软件的Localization变为一个更容易的过程。 使用字符串资源 不要将字符创常量放在程序中，相反，应该将它定义在源文件内：
CString errorMessage; errorMessage.LoadString(IDS_FILE_NOT_FOUND);
宏是非常有用的调试助手，它们可以在你的程序中不受限制 的进行使用，以用来检测输入和退出条件，或者是任何其他的异常情况：
ASSERT(pWnd); VERIFY(loading && userCount > 2);
在开发阶段使用ASSERT，可以确保客户端坚持你的接口的规则。开发过程中产生 assertion failure，这表明调用者与被调用的对象之间的contract被破坏了。 （catastrophic failure） 在发布版中也可以使用VERIFY宏。 仅仅用它来检查灾难性的失败。 在调试版中，ASSERT和VERIFY的作用相同。但是，在发布版中，ASSERT什么也没 有编译，然而，VARIFY会被当作一个规则的语句。
// Get a CLSID GUID constant extern "C" const GUID __declspec(selectany) CLSID_Foo = \ {0x2f3b470c,0xb01f,0x11d3,{0x83,0x8e,0x00,0x00,0x00,0x00,0x00,0x00 }}; // Declare Smart Pointers for IFoo, IBar and IGak interfaces _COM_SMARTPTR_TYPEDEF(IFoo, __uuidof(IFoo)); _COM_SMARTPTR_TYPEDEF(IBar, __uuidof(IBar)); _COM_SMARTPTR_TYPEDEF(IGak, __uuidof(IGak)); STDMETHODIMP SomeClass::Do () { // Create Instance of Foo class and QI for IFoo interface IFooPtr ipFoo(CLSID_Foo); if (ipFoo == 0) return E_NOMEMORY // Call method on IFoo to get IBar IBarPtr ipBar; HRESULT hr = ipFoo->get_Bar(&ipBar); if (FAILED(hr)) return hr; // QI IBar interface for IGak interface IGakPtr ipGak(ipBar); // Call method on IGak hr = ipGak->DoSomething() if (FAILED(hr)) return hr; // Explicitly call Release() ipGak = 0 ipBar = 0
// Get a CLSID GUID constant extern "C" const GUID __declspec(selectany) CLSID_Foo = \ {0x2f3b470c,0xb01f,0x11d3,{0x83,0x8e,0x00,0x00,0x00,0x00,0x00,0x00 }}; STDMETHODIMP SomeClass::Do () { // Create Instance of Foo class and QI for IFoo interface CComPtr ipFoo; HRESULT hr = CoCreateInstance(CLSID_Foo, NULL, CLSCTX_INPROC_SERVER, IID_IFoo, (void **)& ipFoo); if (FAILED(hr)) return hr // Call method on IFoo to get IBar CComPtr ipBar; HRESULT hr = ipFoo->get_Bar(&ipBar); if (FAILED(hr)) return hr; // IBar interface for IGak interface CComQIPtr ipGak(ipBar); // Call method on IGak hr = ipGak->DoSomething()
HRESULT和IErroeInfo COM异常对象。 _com_ptr_t――这个类封装了一个COM接口指针。下面介绍了它了一些通常的用法。 _bstr_t――这个类封装了BSTR数据类型。这个类中的函数和操作符不如ATL BSTR smart 类型丰富，因此，它并不常使用。 _variant_t――这个类封装了VARIANT数据类型。这个类中的函数和操作符不如ATL VARIANT smart类型丰富，因此，它并不常使用。 为了为接口定义一个smart指针，你可以使用_COM_SMARTPTR_TYPEDEF宏：
// Let destructor call IFoo's Release return S_OK; }
2.7.7 活动模板库（Active Template Library） 活动模板库（ ） ATL定义了各种各样的smart类型，如下列表所示。你可以在你的代码中将ATL和DTC 组合起来使用。 ATL smart类型： CComPtr――该类通过对IUnknown接口的AddRef和Release方法进行包装封装了一 个COM接口指针。 CComQIPtr――该类封装了一个COM接口并支持所有IUnknown接口的方法： QueryInterface，AddRef和Release。 CComBSTR――这个类封装了BSTR数据类型。 CComVariant――这个类封装了VARIANT数据类型。 CRegKey――该类提供了操纵Windows注册表输入的一些方法。 CComDispatchDriver――这个类为属性值的获取并设定提供了一些方法，并且可以 通过对象的IDispatch接口来调用方法。 CSecurityDescriptor――这个类提供了一些方法，这些方法可以提出并使用DACL （任意访问控件列表Discretionary Access Control List） 在这一节中，我们调查了前四中smart类型以及它们的用途。下面的这些代码是用ATL smart指针编写的：
_COM_SMARTPTR_TYPEDEF(IFoo, __uui形式：
typedef _com_ptr_t<_com_IIID > IFooPtr;
一旦声明之后，将变量声明为接口的类型并在接口的后面加上Ptr就是一件很简单的事 情了。下面是这个smart指针的一些通常的用法，你还可以在大量的C＋＋例子中看到这一 smart指针的用法。