[COM] COM 中 BSTR 类型简要学习记录

陪她去流浪 桃子 2016年08月29日 编辑 阅读次数:2215

最近一直在弄 COM(组件对象模型)的东西,把戏太多,新概念太多。还是写点东西留念下吧,也算是学过,虽然我很不情愿学 COM。

先看下 BSTR,BSTR(基本字符串、二进制字符串)是由 COM、自动化(Automation)、交互函数(Interop functions)使用的一种字符串数据类型。

在 Windows SDK 的头文件中,BSTR 相关的类型有着如下的定义:

typedef     wchar_t     WCHAR;
typedef     WCHAR       OLECHAR;
typedef     OLECHAR*    BSTR;
typedef     BSTR*       LPBSTR;

注:OLECHAR 也可能被定义成 char,但几乎没有这样定义的 Windows 版本,所以就不再多提了。)

也就是说,BSTR 的底层类型就是一个简单的 wchar_t 字符串。众所周知,在 C语言 中,字符串是以 '\0' 结尾的字符数组来表示(C语言中实际并不存在字符串类型)。因为是以 '\0' 来表示结束的,所以,C语言中的字符串是以计算到第 1 个 '\0' 之前的长度来作为字符串的长度的。因此,其不是二进制安全的。但是,在其它较高级的语言中,出现了真正的字符串类型,如 C++/Visual Basic/Javascript/C#,他们实现的是真正的字符串类型,他们是基于对象的,他们有自己的长度字段。字符串长度的计算不再依靠 '\0' 来求值。

既然 COM 是 语言/平台 无关的一种规范,那么自然就不能再简单地使用 C语言 独自拥有的表示字符串的类型作为通用字符串的传递了。于是 COM 字符串定义了通用的字符串类型,虽然 BSTR 是一个基本类型,一个指向 宽字符数组 的指针类型,但它有着如下的内存模型。

BSTR 是一种复合类型,由三个部分构成:长度前缀、数据字符串、终止符。说明如下:

部分 描述
长度前缀 4 字节无符号整数,记录了 BSTR 中第 2 部分 数据字符串 的长度(字节数),因此不包含自身与终止符;
数据字符串 一个可以存放任意字符的 Unicode 字符串;
终止符 两个 L'\0' 字符,因此是 4 个字节;

注:以上 3 个部分,在内存中紧密相连,中间没有任何间隔(内存空隙、或是因为对齐来带来的),因此:复合类型 BSTR 占用的总内存字节大小为:4 + 数据字符串长度(字符数) * 2 + 4。

值得注意的是:BSTR 指向的是该 复合类型 的第 2 部分的开始地址,简单地说就是:BSTR 这个指针指向 数据字符串 中第 1 个字符,而不是 长度前缀。

因此,在知道了 BSTR 是一种复合类型以后,就不能因为它也是一种 wchar_t 就直接把 wchar_t 字符数组的指针赋值给它。就像下面这样:

BSTR bstr = L"I'm a happy BSTR."; // 错误!

COM 为此提供了一系列的用于操作 BSTR 的函数与类。函数比如:SysAllocString 用于动态分配 BSTR、SysFreeString 用于释放动态分配的 BSTR、SysStringLen 用于计算 BSTR 的长度(字符数),类比如:CComBSTR: 是由 COM 提供的对 BSTR 的包装,能自动管理内存,但不具备引用计数功能、_bstr_t: 是由编译器运行时提供的对 BSTR 的包装,就像是 std::stringchar* 的包装,能自动管理 BSTR 的内存分配,同时还具体引用计数功能。

标签:COM