SAFEARRAY使用实例

From: http://school.ogdev.net/ArticleShow.asp?id=1365&categoryid=10

 

SAFEARRAY使用实例
目录：
SAFEARRAY使用实例... 1

目录：... 1

前言：... 1

何谓SAFEARRAY：... 1

创建SAFEARRAY: 2

方法一：使用SafeArrayAllocDescriptor在栈上创建一维数组... 2

方法二：使用SafeArrayAllocDescriptor和SafeArrayAllocData在堆上创建一维数组... 2

方法三：使用SafeArrayAllocDescriptor和SafeArrayAllocData在堆上创建二维数组... 3

方法四：使用SafeArrayCreate在堆上创建一维数组... 4

方法五：使用SafeArrayCreate在堆上创建二维数组... 5

方法六：使用SafeArrayCreateEx创建包含结构的一维数组... 5

访问SAFEARRAY: 7

方法一：使用SafeArrayAccessData方法... 7

方法二：使用SafeArrayGetElement和SafeArrayPutElement 7

组件/客户中传递SAFEARRAY的原则：... 8



前言：
SAFEARRAY使用总是困扰很多人，为了把这个问题说个明白，我把我目前掌握的知识做个总结


何谓SAFEARRAY：
SAFEARRAY实际上是一个结构，关于这部分可以参考MSDN。

ms-help://MS.MSDNQTR.2003FEB.2052/automat/htm/chap7_9ntx.htm

我们不需要关心16位操作系统下的定义，因为我们团队只在WIN2000以上平台下开发。


创建SAFEARRAY:
方法一：使用SafeArrayAllocDescriptor 在栈上创建一维数组
//创建SAFEARRAY数组，每个元素为long型，该数组是一维数组

long nData[10]={1,2,3,4,5,6,7,8,9,10};


SAFEARRAY* pArray=NULL;

HRESULT hr=SafeArrayAllocDescriptor(1,&pArray);//创建SAFEARRAY结构的对象

pArray->cbElements=sizeof(nData[0]);
pArray->rgsabound[0].cElements=10;
pArray->rgsabound[0].lLbound=0;
pArray->pvData=nData;
pArray->fFeatures=FADF_AUTO|FADF_FIXEDSIZE;// FADF_AUTO指定在栈上分配数据，并且大小不可以改变（固定为10）



//访问SAFEARRAY数组

long* pValue=NULL;

SafeArrayAccessData(pArray,(void**)&pValue);

long Low(0),High(0);

hr=SafeArrayGetLBound(pArray,1,&Low);//维数索引从1开始

hr=SafeArrayGetUBound(pArray,1,&High);//维数索引从1开始



SafeArrayUnaccessData(pArray);

SafeArrayDestroy(pArray);

这种方法 在栈上分配数组元素所占的空间，即nData数组所用的空间





方法二：使用SafeArrayAllocDescriptor和SafeArrayAllocData 在堆上创建一维数组
//创建SAFEARRAY数组，每个元素为long型，该数组是一维数组

long nData[10]={1,2,3,4,5,6,7,8,9,10};


SAFEARRAY* pArray=NULL;
HRESULT hr=SafeArrayAllocDescriptor(1,&pArray);//创建SAFEARRAY结构的对象
pArray->cbElements=sizeof(nData[0]);
pArray->rgsabound[0].cElements=10;
pArray->rgsabound[0].lLbound=0;
SafeArrayAllocData(pArray);


long* pData=NULL;
SafeArrayAccessData(pArray,(void**)&pData);
long l(0),h(0);
SafeArrayGetLBound(pArray,1,&l);
SafeArrayGetUBound(pArray,1,&h);
long Size=h-l+1;
//SafeArrayAccessData(pArray,(void**)&pData);

for(long Idx=l;Idx<SIZE;++IDX)
{
pData[Idx]=nData[Idx];
}

SafeArrayUnaccessData(pArray);



//访问SAFEARRAY数组

long* pValue=NULL;
SafeArrayAccessData(pArray,(void**)&pValue);
long Low(0),High(0);
hr=SafeArrayGetLBound(pArray,1,&Low);//维数索引从1开始
hr=SafeArrayGetUBound(pArray,1,&High);//维数索引从1开始

SafeArrayUnaccessData(pArray);
SafeArrayDestroy(pArray);


方法三：使用SafeArrayAllocDescriptor和SafeArrayAllocData在堆上创建二维数组
SAFEARRAY* pArray=NULL;

HRESULT hr=SafeArrayAllocDescriptor(2,&pArray);
pArray->rgsabound[0].lLbound=0;
pArray->rgsabound[0].cElements=3;
pArray->rgsabound[1].lLbound=0;
pArray->rgsabound[1].cElements=3;

pArray->cbElements=sizeof(long);
hr=SafeArrayAllocData(pArray);



long lDimension[2];

long x=1;

//为第一行赋值

for(long i=0;i<3;++i)
{
lDimension[1]=0;//行
lDimension[0]=i;//列
SafeArrayPutElement(pArray,lDimension,&x);
x++;
}

//为第二行赋值

for(long i=0;i<3;++i)
{
lDimension[1]=1;//行
lDimension[0]=i;//列
SafeArrayPutElement(pArray,lDimension,&x);
x++;
}



//读取SafeArray中第二行第三列的数据

long y(0);
lDimension[1]=1;
lDimension[0]=2;
SafeArrayGetElement(pArray,lDimension,&y);

SafeArrayDestroy(pArray);



二维SAFEARRAY数组使用的时候下标要注意,这里 采用的是列主序的方式,即lDimension[1]代表行，lDimension[0]代表列。





方法四：使用SafeArrayCreate在堆上创建一维数组
SAFEARRAYBOUND Bound[1];

Bound[0].lLbound=0;

Bound[0].cElements=10;

SAFEARRAY* pArray=SafeArrayCreate(VT_I4,1,Bound);

long* pData=NULL;

HRESULT hr=SafeArrayAccessData(pArray,(void**)&pData);

long Low(0),High(0);

SafeArrayGetLBound(pArray,1,&Low);

SafeArrayGetUBound(pArray,1,&High);

long Size=High-Low+1;

for(long Idx=Low;Idx<SIZE;++IDX)

{

pData[Idx]=Idx;

cout<<PDATA[IDX]<<ENDL;

}

SafeArrayUnaccessData(pArray);

SafeArrayDestroy(pArray);



方法五：使用SafeArrayCreate在堆上创建二维数组
SAFEARRAYBOUND Bound[2];

Bound[0].lLbound=0;

Bound[0].cElements=3;

Bound[1].lLbound=0;

Bound[1].cElements=3;

SAFEARRAY* pArray=SafeArrayCreate(VT_I4,2,Bound);



long Demen[2];

for(long i=0;i<3;++i)

{

for(long j=0;j<3;++j)

{

Demen[1]=i;

Demen[0]=j;

long x=i*j;

SafeArrayPutElement(pArray,Demen,&x);

}

}



//访问二维数组

for(long i=0;i<3;++i)

{

for(long j=0;j<3;++j)

{

Demen[1]=i;

Demen[0]=j;

long x(0);

SafeArrayGetElement(pArray,Demen,&x);

cout<<"("<<I<<","<<J<<") ?<<x<<endl;

}





library SarstShapeLib

{



importlib("stdole2.tlb");

[

uuid(DBDCC0F1-38F3-4EB4-A5BD-79A3707BDE9C),

helpstring("Shape Class")

]

coclass Shape

{

[default] interface IShape;

};

struct _BookMarkSchema;

};





方法的实现为：

STDMETHODIMP CShape::GetBookMarkName(BSTR UserID, SAFEARRAY** pBookMarkNames)

{

//获得GIS库信息

CSarstConfigure Configure;

string Flag("GIS");

string IP,Database,UserName,Key,Context;

Configure.GetDatabaseInfo(Flag,IP,Database,UserName,Key,Context);



//读取图层属性数据

USES_CONVERSION;

string user(CString(UserID).GetBuffer());

string sql("SELECT 书签名,书签描述,时间 FROM 用户书签表 where 用户ID='"+user+"' order by 时间 desc");

FBData data(IP,Database,UserName,Key);

table t=data.GetTable(sql);

if(t.empty())

{

return S_FALSE;

}

//创建SafeArray

IRecordInfo* pRecordInfo=NULL;

HRESULT hr=::GetRecordInfoFromGuids(LIBID_SarstShapeLib,1,0,GetUserDefaultLCID(),IID_STRUCT_BookMarkSchema,&pRecordInfo);

if(FAILED(hr))

return E_FAIL;

*pBookMarkNames=::SafeArrayCreateVectorEx(VT_RECORD,0,long(t.size()-1),(void*)pRecordInfo);

_BookMarkSchema* pData=NULL;

hr=::SafeArrayAccessData(*pBookMarkNames,(void**)&pData);

for(int i=0;i<INT(T.SIZE()-1);I++)

{

t[i+1].at(0).CopyTo(&pData[i].Name);

t[i+1].at(1).CopyTo(&pData[i].Context);

t[i+1].at(2).ChangeType(VT_BSTR);

t[i+1].at(2).CopyTo(&pData[i].Time);

}

::SafeArrayUnaccessData(*pBookMarkNames);

pRecordInfo->Release();

return S_OK;

}

访问SAFEARRAY:
方法一：使用SafeArrayAccessData方法
这种方法可以参见创建SAFEARRAY之方法一

请注意，访问完后要调用SafeArrayUnaccessData方法，并且调用SafeArrayDestroy销毁数组

这种方式通常用于访问一位数组

方法二：使用SafeArrayGetElement和SafeArrayPutElement
这种方法可以参见创建SAFEARRAY之方法五

这种方式在访问多维数组的时候很有用

组件/客户中传递SAFEARRAY的原则：
1） 在堆上创建SAFEARRAY数组

2） 一方创建，一方回收

3） 接收方不可以修改SAFEARRAY的数据，只能读或者销毁