数据类型 3

。组件API及接口指针中，除了IUnknown::AddRef()和
IUnknown::Release()两个函数外，其它所有的函数，都以 HRESULT 作为返回值。

 

HRESULT 值含义
S_OK 0x00000000 成功
S_FALSE 0x00000001 函数成功执行完成，但返回时出现错误
E_INVALIDARG 0x80070057 参数有错误
E_OUTOFMEMORY 0x8007000E 内存申请错误
E_UNEXPECTED 0x8000FFFF 未知的异常
E_NOTIMPL 0x80004001 未实现功能
E_FAIL 0x80004005 没有详细说明的错误。一般需要取得 Rich Error 错误信息(注1)
E_POINTER 0x80004003 无效的指针
E_HANDLE 0x80070006 无效的句柄
E_ABORT 0x80004004 终止操作
E_ACCESSDENIED 0x80070005 访问被拒绝
E_NOINTERFACE 0x80004002 不支持接口

 

 

 

============================================================================

/BSTR 其实是一个指针类型，它的内存结构是：

 

BSTR 是一个指向 UNICODE 字符串的指针,因此 BSTR 和 LPOLESTR 可以在一定程度上混用，但一定要注意：
　　有函数 fun(LPCOLESTR lp)，则你调用 BSTR p=...; fun(p); 正确
　　有函数 fun(const BSTR bstr)，则你调用 LPCOLESTR p=...; fun(p); 错误！！！

 

SysAllocString() 申请一个 BSTR 指针，并初始化为一个字符串
SysFreeString() 释放 BSTR 内存
SysAllocStringLen() 申请一个指定字符长度的 BSTR 指针，并初始化为一个字符串
SysAllocStringByteLen() 申请一个指定字节长度的 BSTR 指针，并初始化为一个字符串
SysReAllocStringLen() 重新申请 BSTR 指针
CString 函数说明
AllocSysString() 从 CString 得到 BSTR
SetSysString() 重新申请 BSTR 指针，并复制到 CString 中
CComBSTR 函数
ATL 的 BSTR 包装类。在 atlbase.h 中定义
Append()、AppendBSTR()、AppendBytes()、ArrayToBSTR()、
BSTRToArray()、AssignBSTR()、Attach()、Detach()、Copy()、CopyTo
()、Empty()、Length()、ByteLength()、ReadFromStream()、
WriteToStream()、LoadString()、ToLower()、ToUpper()
运算符重载：!,!=,==,<,>,&,+=,+,=,BSTR
太多了，但从函数名称不能看出其基本功能。详细资料，查看MSDN 吧。
另外，左侧函数，有很多是 ATL 7.0 提供的，VC6.0 下所带的 ATL 3.0 不支
持。
由于我们将来主要用 ATL 开发组件程序，因此使用 ATL 的 CComBSTR 为
主。VC也提供了其它的包装类 _bstr_t。
五、各种字符串类型之间的转换
　　1、函数 WideCharToMultiByte()，转换 UNICODE 到 MBCS。使用范例：
LPCOLESTR lpw = L"Hello,你好";
size_t wLen = wcslen( lpw ) + 1; // 宽字符字符长度，+1表示包含字符串结束符
int aLen=WideCharToMultiByte( // 第一次调用，计算所需 MBCS 字符串字节长度
CP_ACP,
0,
lpw, // 宽字符串指针
wLen, // 字符长度
NULL,0, // 参数0表示计算转换后的字符空间
NULL,
NULL);
LPSTR lpa = new char [aLen];
WideCharToMultiByte(
CP_ACP,
0,
lpw,
wLen,
lpa, // 转换后的字符串指针
aLen, // 给出空间大小
NULL,
NULL);
// 此时，lpa 中保存着转换后的 MBCS 字符串
... ... ... ...
delete [] lpa;

 

 

2、函数 MultiByteToWideChar()，转换 MBCS 到 UNICODE。使用范例：
LPCSTR lpa = "Hello,你好";
size_t aLen = strlen( lpa ) + 1;
int wLen = MultiByteToWideChar(
CP_ACP,
0,
lpa,
aLen,
NULL,
0);
LPOLESTR lpw = new WCHAR [wLen];
MultiByteToWideChar(
CP_ACP,
0,
lpa,
aLen,
lpw,

wLen);
... ... ... ...
delete [] lpw;

 

3、使用 ATL 提供的转换宏。
　
A2BSTR OLE2A T2A W2A
A2COLE OLE2BSTR T2BSTR W2BSTR
A2CT OLE2CA T2CA W2CA
A2CW OLE2CT T2COLE W2COLE
A2OLE OLE2CW T2CW W2CT
A2T OLE2T T2OLE W2OLE
A2W OLE2W T2W W2T
上表中的宏函数，其实非常容易记忆：
2 好搞笑的缩写，to 的发音和 2 一样，所以借用来表示“转换为、转换到”的含义。
A ANSI 字符串，也就是 MBCS。
W、OLE 宽字符串，也就是 UNICODE。
T 中间类型T。如果定义了 _UNICODE，则T表示W；如果定义了 _MBCS，则T表示A
C const 的缩写

#include <atlconv.h>
void fun()
{
USES_CONVERSION; // 只需要调用一次，就可以在函数中进行多次转换LPCTSTR lp = OLE2CT( L"Hello,你好") );
... ... ... ...
// 不用显式释放 lp 的内存，因为
// 由于 ATL 转换宏使用栈作为临时空间，函数结束后会自动释放栈空间。
}
　　使用 ATL 转换宏，由于不用释放临时空间，所以使用起来非常方便。但是考虑到栈空间的尺寸（VC 默认
2M），使用时要注意几点：
1、只适合于进行短字符串的转换；
2、不要试图在一个次数比较多的循环体内进行转换；
3、不要试图对字符型文件内容进行转换，因为文件尺寸一般情况下是比较大的；
4、对情况 2 和 3，要使用 MultiByteToWideChar() 和 WideCharToMultiByte()；

六、VARIANT

bool 1(char) 0(false) 1(true)
BOOL 4(int) 0(FALSE) 1(TRUE)
VT_BOOL 2(short int) 0(VARIANT_FALSE) -1(VARIANT_TRUE)