CComBSTR 的类成员及使用方法

CComBSTR 类

Visual Studio 2013

其他版本

此选件类是 BSTR的s.包装。

class CComBSTR

成员

公共构造函数

名称	说明
CComBSTR::CComBSTR	构造函数。
CComBSTR::~CComBSTR	该析构函数。

公共方法

名称	说明
CComBSTR::Append	追加字符串。m_str。
CComBSTR::AppendBSTR	追加 BSTR 到 m_str。
CComBSTR::AppendBytes	追加指定的字节数。m_str。
CComBSTR::ArrayToBSTR	在safearray创建从每个元素第一个字符的 BSTR 并将它附加到 CComBSTR 对象。
CComBSTR::AssignBSTR	分配 BSTR 到 m_str。
CComBSTR::Attach	附加 BSTR 到 CComBSTR 对象。
CComBSTR::BSTRToArray	创建一个从零开始的一维safearray，其中数组的每个元素是从 CComBSTR 对象的一个字符。
CComBSTR::ByteLength	在字节返回 m_str 的长度。
CComBSTR::Copy	返回 m_str的副本。
CComBSTR::CopyTo	通过 [out] 参数返回 m_str 的副本
CComBSTR::Detach	分离 CComBSTR 对象的 m_str。
CComBSTR::Empty	释放 m_str。
CComBSTR::Length	返回 m_str的长度。
CComBSTR::LoadString	加载一字符串资源。
CComBSTR::ReadFromStream	从流加载一 BSTR 对象。
CComBSTR::ToLower	将字符串转换为小写。
CComBSTR::ToUpper	将字符串转换为大写。
CComBSTR::WriteToStream	保存 m_str 入流。

公共运算符

名称	说明
CComBSTR::operator BSTR	转换为 BSTR的一 CComBSTR 对象。
CComBSTR::operator !	返回 true 或 false，根据 m_str是否 NULL。
CComBSTR::operator !=	CComBSTR 的字符串比较。
CComBSTR::operator &	返回 m_str地址。
CComBSTR::operator +=	追加 CComBSTR 为对象。
CComBSTR::operator <	CComBSTR 的字符串比较。
CComBSTR::operator =	赋值。m_str。
CComBSTR::operator ==	CComBSTR 的字符串比较。
CComBSTR::operator >	CComBSTR 的字符串比较。

公共数据成员

名称	说明
CComBSTR::m_str	包含 BSTR 与 CComBSTR 对象。

备注

CComBSTR 选件类是 BSTR的包装，长度为前缀的字符串。 该长度存储为上面数据的内存位置的整数。该字符串。

最后，在计数的字符，但也可以包含在字符串中后，嵌入null字符 BSTR Null终止。 字符数不依赖于字符串长度，不带第一个null字符。

说明
CComBSTR 选件类提供大量该名称的成员(构造函数、赋值运算符和比较运算符)若要拍摄ANSI或Unicode字符串作为参数。 因为临时Unicode字符串在内部，通常为这些功能创建ANSI版本比其Unicode重复效率低。 为提高效率，尽可能使用Unicode版本。

说明
由于Visual Studio实现改进的查找行为.NET，应实现代码(如 bstr = L"String2" + bstr;，以前的版本可能生成的，作为 bstr = CStringW(L"String2") + bstr。

有关小心列表，在使用 CComBSTR中，请参见 编程时CComBSTR。

要求

Header: atlbase.h