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