SAFEARRAY使用实例

最新推荐文章于 2023-09-20 03:05:27 发布
最新推荐文章于 2023-09-20 03:05:27 发布
阅读量1.6k 收藏 1
点赞数
文章标签： null database struct string interface library

原文地址：http://www.chinaitpower.com/A200507/2005-07-27/168883.html

目录：

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;

         }

     }

     SafeArrayDestroy(pArray);

 

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

使用SAFEARRAY传递UDT(自定义结构)是一项常用的技术，MSDN文档描述得比较齐全，要注意的一点是，自定义结构要求有自己的GUID，这必须在IDL文件中定义。同时还必须要使用IRecordInfo接口，该接口将和数组一起传递出去，IRecordInfo接口内部记录了UDT的描述信息。

IDL文件中：

[uuid(810930AA-9229-46e7-B20C-41F6218D0B1A)]

struct _BookMarkSchema

{

     BSTR Name;

     BSTR Context;

     BSTR Time;

};

 

…

interface IShape : IDispatch

{

[id(6), helpstring("获取属于某用户的书签名称列表")] HRESULT GetBookMarkName([in] BSTR UserID,[out] SAFEARRAY(struct _BookMarkSchema)* pBookMarkNames);

}

 

 

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的数据，只能读或者销毁

followme163
关注
如何构造一个元素类型为Struct的SafeArray
张羿的CSDN专栏
08-12 3959
在有些时候，我们需要构造一个元素类型为Struct的SafeArray，在MSDN并没有文档解释到底应该如何去做到这一点，下面的代码片断解释了如何去构造这样一个SafeArray。假设我们有如下的Struct： struct myStruct {    
SafeArray的使用
蓝星星
07-16 1322
SafeArray
lan354898254的专栏
06-06 979
首先介绍SafeArray使用，在介绍SafeArray中的结构。看完该节文章，SafeArray的陌生感一扫而去。   SafeArray 在ADO编程中经常使用。它的主要目的是用于automation中的数组型参数的传递。因为在网络环境中，数组是不能直接传递的，而必须将其包装成 SafeArray。实质上SafeArray就是将通常的数组增加一个描述符，说明其维数、长度、边界、元素类型等
SafeArrayAccessData，SafeArrayUnaccessData使用
FairLikeSnow的博客
04-01 1462
    SafeArray是VB中的数组存储方式。通过SafeArray，可以在VC++和VB间相互调用。SafeArray也是Automation中的标准数组存储方式。 1. SafeArrayAccessData 函数原型: HRESULT SafeArrayAccessData( SAFEARRAY * psa, void HUGEP ** ppvData ); 这个函数用于获取SafeArray的数据指针，并锁定SafeArray数组的数据。
Com_SafeArray 使用实例
10-25
标题"Com_SafeArray 使用实例"暗示了我们将探讨的是COM（Component Object Model）技术中的一种特殊数据结构——SafeArray。SafeArray是COM中用于安全传输和处理数组的一种机制，尤其适用于跨进程通信。描述指出，这...
SAFEARRAY代码实例
08-12
这个例子展示了如何创建一个包含BSTR（Unicode字符串）的`SAFEARRAY`，并将字符串写入和读出数组。 ### 在实际编程中的应用 `SAFEARRAY`广泛应用于各种Windows API和COM接口中，特别是在自动化、数据交换和控件编程...
_SAFEARRAY_User_SafeArray_
10-02
例如，可能会包含创建一个`SAFEARRAY`实例，填充数据，然后读取和显示数据的函数。代码可能还涉及到错误处理，确保在出现异常时正确清理资源。 在实际应用中，`SAFEARRAY`常用于自动化对象（Automation Objects）的...
WINDOWS-基础：SafeArray的使用方法
dixiongbi7761的博客
12-05 250
1 SafeArray的作用 　　使用SafeArray SafeArray是VB中的数组存储方式。通过SafeArray，可以在VC++和VB间相互调用。 　　SafeArray也是Automation中的标准数组存储方式。SAFEARRAY的主要目的是用于automation中的数组型参数的传递。因为在网络环境中，数组是不能直接传递的，而必须将其包装成SafeArray。 ...
在COM中使用数组参数-SafeArray[转载/修改]
liziyun537的专栏
10-24 1003
<br />目录何谓SAFEARRAY创建SAFEARRAY方法一：使用SafeArrayAllocDescriptor在栈上创建一维数组方法二：使用SafeArrayAllocDescriptor和SafeArrayAllocData在堆上创建一维数组方法三：使用SafeArrayAllocDescriptor和SafeArrayAllocData在堆上创建二维数组方法四：使用SafeArrayCreate在堆上创建一维数组方法五：使用SafeArrayCreate在堆上创建二维数组方法六：使用SafeA
关于SAFEARRAY的，转载了篇文章，比较全
热门推荐
crybird的C/C++
06-27 1万+
有个问题，64位COM组件调用32位COM组件(进程外)的时候： 32位组件里引入_IDTExtensibility2接口，64调用的时候失败； 如果不用引入的方法，而把接口函数写到IDL里，则调用成功。 比较奇怪。 （关键是接口函数有SAFEARRAY**类型的参数，让系统默认转就失败。 返回的错误时加载DLL模块失败，其实是代理存根调用有异常，可能转 SAFEARRAY的时候有
SAFEARRAY(安全数组)使用详解
shuigsls的专栏
07-06 7043
SAFEARRAY(安全数组)使用详解一，何谓SAFEARRAY(安全数组)：winddows操作系统与使用 SAFEARRAY 定义。 下列 SAFEARRAY 结构是 SAFEARRAY 典型、 一般定义：typedef struct FARSTRUCT tagSAFEARRAY {   unsigned short cDims;       // 安全数组的大小   un
LISP中的SAFEARRAY - 动态数组的强大工具
VcuOcaml的博客
09-20 156
SAFEARRAY是LISP编程语言中的一种动态数组工具，它提供了方便且灵活的方式来处理和操作数组。本文提供了SAFEARRAY的基本概念、用法和示例代码，希望对您理解和使用SAFEARRAY有所帮助。SAFEARRAY是LISP中的一种数据类型，它可以存储多个元素，并且可以根据需要自动调整大小。通过以上示例，您可以看到SAFEARRAY的使用方式和其在LISP编程中的潜力。然后，我们创建了一个新的SAFEARRAY。这只是一些常见的SAFEARRAY操作示例，您可以根据需要进行更多的操作和探索。
safearray的使用方法
水里的空气的专栏
10-22 3549
<br />安全数组可以存储多维数据。在标准C++表示中，可以定义这样的数组：long myArr[2][4]。在安全数组中，这种类型的数组就是2维(cDims)的。安全数组的每一维都有自己的SAFEARRAYBOUND结构，它由SAFEARRAY结构的rgsabound[]成员建立。每个SAFEARRAYBOUND定义了该维所含元素的数量和启始索引值。例如在数组 long myArray[2][4] 中，创建了两个SAFEARRAYBOUND结构，每一维都含有4个元素(cElements) 并且下限(lL
variant_t 数据类型
wanglei2258的专栏
01-28 682
_variant_t类封闭了VARIANT数据类型,VARIANT是一个结构体类型,我们可以看一下它的定义typedef struct tagVARIANT  {   VARTYPE vt;   unsigned short wReserved1;   unsigned short wReserved2;   unsigned short wReserved3;   union {    
C++ access数据库中字段信息获取
chouxia9923的博客
11-24 876
void CDataControl::GetFieldNameCn(const CString& sTableName,CADORecordset* pAdoAccess,const CString& sNameEn, CString& sNameCn) { SAFE...
C# 创建 safearray 作为com接口参数
最新发布
09-11
在C#中，创建一个安全数组（SafeArray）作为COM接口的参数，需要使用到.NET框架提供的COM互操作性特性。SafeArray是一个在COM中用于存储数组数据的结构，它可以包含不同类型的元素，并且具有内存管理功能，确保在COM环境中传递时不会发生内存泄漏。 要在C#中创建SafeArray，通常需要引入`System.Runtime.InteropServices`命名空间，然后使用对应的属性和类型。下面是一个简单的例子，展示如何创建一个SafeArray并作为COM接口的方法参数： ```csharp using System; using System.Runtime.InteropServices; class Program { // 假设有一个COM方法，需要一个SafeArray作为参数 [DllImport("YourComLibrary.dll", PreserveSig = false)] private static extern void YourComMethod([In, Out] IntPtr pArray); // 创建一个SafeArray并将其指针传递给COM方法 static void Main() { // 创建一个空的SafeArray实例，这里以整型为例 int[] arrayElements = new int[10]; IntPtr pArray = CreateSafeArray(arrayElements); // 调用COM方法并传递SafeArray指针 YourComMethod(pArray); // 清理SafeArray资源 Marshal.DestroyStructure(pArray, typeof(SafeArrayBOUND)); for (int i = 0; i < arrayElements.Length; i++) { Marshal.DestroyStructure(Marshal.ReadIntPtr(pArray, i * IntPtr.Size), typeof(int)); } Marshal.FreeCoTaskMem(pArray); } // 定义创建SafeArray的方法 static IntPtr CreateSafeArray(int[] elements) { // 这里简化处理，实际应根据实际情况构造SafeArray结构 int length = Marshal.SizeOf(typeof(int)) * elements.Length; IntPtr pArray = Marshal.AllocCoTaskMem(length); // 填充SafeArray for (int i = 0; i < elements.Length; i++) { IntPtr pElement = new IntPtr(pArray.ToInt32() + i * Marshal.SizeOf(typeof(int))); Marshal.WriteInt32(pElement, elements[i]); } return pArray; } } ``` 请注意，上述代码是一个简化的示例，实际使用时需要根据具体的COM方法和SafeArray的类型进行相应的调整。创建SafeArray的具体实现可能会更加复杂，因为需要正确地设置SafeArray的边界和维数信息。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值