关于SAFEARRAY的用法.doc

关于SAFEARRAY的用法 1 使用SafeArray SafeArray是VB中的数组存储方式。通过SafeArray，可以在VC++和VB间相互调用。SafeArray也是Automation中的标准数组存储方式。 1.1 SafeArray处理函数 COM提供了一套API用于处理SafeArray。为了保证程序和SafeArray结构无关，程序中建立、读取、更改和释放SafeArray都应该通过这些API进行，而不应该直接读写SafeArray结构。 下面介绍常用的SafeArray处理函数。 1.1.1 建立SafeArray SAFEARRAY* SafeArrayCreate( VARTYPE vt, unsigned intcDims, SAFEARRRAYBOUND *rgsabound ); SAFEARRAY SafeArrayCreateEx( VARTYPE vt, unsigned int cDims, SAFEARRRAYBOUND * rgsabound PVOID pvExtra ); SAFEARRAY* SafeArrayCreateVector( VARTYPE vt, long lLbound, unsigned int cElements ); SAFEARRAY* SafeArrayCreateVectorEx( VARTYPE vt, long lLbound, unsigned int cElements, LPVOID pvExtra ); SafeArrayCreate于建立多维普通数组。SafeArrayCreateEx用于建立多维自定义类型或接口指针数组。SafeArrayCreateVector用于建立一维普通数组。SafeArrayCreateVectorEx用于建立一维自定义类型或接口指针数组。 1.1.2 释放数组 HRESULT SafeArrayDestroy( SAFEARRAY * psa ); SafeArrayDestroy用于释放创建的SafeArray数组。 1.1.3 访问数据 HRESULT SafeArrayAccessData( SAFEARRAY *psa, void HUGEP** ppvData ); HRESULT SafeArrayUnaccessData( SAFEARRAY * psa ); SafeArrayAccessData函数返回数组的指针。而SafeArrayUnaccessData释放通过SafeArrayAccessData所取得的指针。 1.2 SafeArray相关处理 1.2.1 创建SafeArray数组 创建SafeArray可以使用COM提供的四个创建函数之一。所有的创建函数都返回一个SafeArray指针。通过这个指针可以读写SafeArray中的数据。SafeArray使用完后必须释放。 1. SafeArrayCreateVector SAFEARRAY* SafeArrayCreateVector( VARTYPE vt, long lLbound, unsigned int cElements ); 这个函数用来创建简单类型的一维数组。这个函数有三个参数：vt是数组类型、lLbound是数组下界值（最小下标）和数组长度。vt的取值如下表： vt值 类型 VT_UI1 无符号1字节整数(BYTE)数组 VT_UI2 无符号2字节整数(WORD)数组 VT_UI4 无符号4字节整数(DWORD)数组 VT_UINT 无符号整数(UINT)数组 VT_INT 有符号整数(INT)数组 VT_I1 有符号1字节整数数组 VT_I2 有符号2字节整数数组 VT_I4 有符号4字节整数数组 VT_R4 IEEE 4字节浮点数(float)数组 VT_R8 IEEE 8字节浮点数(double)数组 VT_CY 8字节定点数货币值数组 VT_BSTR VB字符串数组 VT_DECIMAL 12字节定点数(大数字)数组 VT_ERROR 标准