COM中的BSTR字符的使用以及各种字符串之间的转换.docVIP

COM中的BSTR字符的使用 概述(Basic STRing) 它被描述成一个与自动化相兼容的类型，由于操作系统提供相应的API函数(如SysAllocString)来管理它以及一些默认的调度代码。因此BSTR实际上就是一个COM字符串，但它却在自动化技术以外的多种场合下得到广泛使用。 对于C++，Windows头文件wtypes.h中定义如下： 　　typedef wchar_t WCHAR; 　　typedef WCHAR OLECHAR; 　　typedef OLECHAR __RPC_FAR *BSTR; 使用以null结尾的简单字符串在COM component间传递不太方便。因此，标准BSTR是一个有长度前缀和null结束符的OLECHAR数组。BSTR的前4字节是一个表示字符串长度的前缀。BSTR长度域的值是字符串的字节数，并且不包括0结束符 BSTR结构 与BSTR操作相关的一些API函数 ============================================================== 1、SysAllocString函数用于创建一个BSTR字符串 BSTR SysAllocString(const OLECHAR * psz); 2、SysReAllocString用于在一个已有的BSTR字符串的基础上重新建立一个BSTR字符串 INT SysReAllocString(BSTR* pbstr,const OLECHAR* psz); 3、SysAllocStringLen按照指定的长度分配一个BSTR字符串 BSTR SysAllocStringLen(const OLECHAR * strIn, UINT ui); 4、SysReAllocStringLen函数是在已有的字符串的基础上按指定长度重新分配一个新的BSTR字符串。 INT SysReAllocStringLen(BSTR* pbstr,const OLECHAR* psz,unsigned int len); 5、SysFreeString是释放一个BSTR字符串，BSTR字符串用后必须用此函数进行释放， void SysFreeString(BSTR bstrString);UINT SysStringLen(BSTR); 6、SysStringLen求一个BSTR字符串的长度，如： UINT SysStringLen(BSTR); 7、SysStringByteLen求一个BSTR字符串的字节长度， UINT SysStringByteLen(BSTR bstr); 8、SysAllocStringByteLen是按字节长度分配一个BSTR字符串。 BSTR SysAllocStringByteLen(LPCSTR psz,UINT len); ============================================================== 使用BSTR情况: ●COM interface接口定义，并且不希望额外提供custom marshaling库（MDIL生成或开发人员自己订制），必须使用BSTR传递字符串。使用C/C++类型的字符串在COM DLL传递字符串，表面上可以使用，但违背了COM的基本规则，并且给以后的扩展留下了隐患。例如，把一个In-process COM Object(简单说COM DLL)改成out-of-process object（COM EXE）。理论上，客户端的代码应该不做任何改变。但如果是用了C/C++字符串，又希望只使用系统的automation mashaller（Oleaut32.dll），就会出错。 　　●如果可以提供custom marshaling，也推荐使用BSTR。 　　●客户要求接口必须使用BSTR，和客户讨论后，不能修改。 　　●使用的外部库的接口使用BSTR 不使用的情况： 　　●不推荐在IDL结构体中定义BSTR成员，会给结构体的复制和释放带来麻烦。最好直接使用限定最大长度的TCHAR数组。如果确实需要传递变长字符串，BSTR应该被定义成独立的参数或者使用独立的get/set接口。 ●尽可能缩小的BSTR及相关类型的作用域范围。类的成员变量和函数参数不使用BSTR。局部变量要尽快释放类的内部不使用BSTR。代码处理逻辑中只在接口直接相关部分使用BSTR。接收到一个BSTR时，尽量立刻变成C/C++的字符串副本进行处理。在需要传递BSTR参数前产生BSTR，用过立即释放。 BSTR、char*和CS