使用SAFEARRAY传送对象

下载本文示例代码
　　使用SAFEARRAY　　我们将使用SAFEARRAY来通过COM传送串行化的对象。这部分将介绍如何建立和使用SAFEARRAY类型。　　SAFEARRAY是数据结构的一种。这种结构也没有什么特别的，你只需要正确地设置它，当然你要知道其中一些颇为复杂的规定。为了确保SAFEARRAY被正确地使用，它有一系列用作管理的API函数。这些API的函数负责创建、调整大小和删除SAFEARRAY。不幸的是，有关这些API函数的文档是相当少的。　　对于SAFEARRAY的内部结构我们并不关心，但了解一下是值得的。以下就是SAFEARRAY的Win32定义：　　typedef struct tagSAFEARRAY　　　{　　　　unsigned short cDims;　　　　unsigned short fFeatures;　　　　unsigned long cbElements;　　　　unsigned long cLocks;　　　　void * pvData;　　　　SAFEARRAYBOUND rgsabound[ 1 ];　　　} SAFEARRAY;　　这个结构的成员（cDims，cLocks等）是通过API函数来设置和管理的。真正的数据存放在pvData成员中，而SAFEARRAYBOUND结构定义该数组结构的细节。以下就是该结构成员的简要描述： 成员 描述 cDims 数组的维数 fFeatures 用来描述数组如何分配和如何被释放的标志 cbElements 数组元素的大小 cLocks 一个计数器，用来跟踪该数组被锁定的次数 pvData 指向数据缓冲的指针 rgsabound 描述数组每维的数组结构，该数组的大小是可变的　　rgsabound是一个有趣的成员，它的结构不太直观。它是数据范围的数组。该数组的大小依safe array维数的不同而有所区别。rgsabound成员是一个SAFEARRAYBOUND结构的数组--每个元素代表SAFEARRAY的一个维。　　typedef struct tagSAFEARRAYBOUND　　　{　　　　unsigned long cElements;　　　　unsigned long lLbound;　　　} SAFEARRAYBOUND;　　维数被定义在cDims成员中。例如，一个'C'类数组的维数可以是[3][4][5]-一个三维的数组。如果我们使用一个SAFEARRAY来表示这个结构，我们定义一个有三个元素的rgsabound数组--一个代表一维。　　cDims = 3;　　　 ...　　SAFEARRAYBOUND rgsabound[ 3 ];　　rgsabound[0]元素定义第一维。在这个例子中ILBOUND元素为0，是数组的下界。cElements成员的值等于三。数组的第二维（[4]）可以被rgsabound结构的第二个元素定义。下界也可以是0，元素的个数是4，第三维也是这样。要注意，由于这是一个"C"数组，因此由0开始，对于其它语言，例如Visual Basic，或者使用一个不同的开始。该数组的详细情况如下所示： 元素 cElements ILbound rgsabound[0] 3 0 rgsabound[1] 4 0 rgsabound[2] 5 0　　关于SAFEARRAYBOUND结构其实还有很多没说的。我们将要使用的SAFEARRAY只是一个简单的单维字节数组。我们通过API函数创建数组的时候，SAFEARRAYBOUND将会被自动设置。只有在你需要使用复杂的多维数组的时候，你才需要操作这个结构。　　还有一个名字为cLocks的成员变量。很明显，它与时间没有任何的关系--它是一个锁的计数器。该参数是用来控制访问数组数据的。在你访问它之前，你必须锁定数据。通过跟踪该计数器，系统可以在不需要该数组时安全地删除它。共3页。 1 2 3 8 : 　　使用SAFEARRAY　　我们将使用SAFEARRAY来通过COM传送串行化的对象。这部分将介绍如何建立和使用SAFEARRAY类型。　　SAFEARRAY是数据结构的一种。这种结构也没有什么特别的，你只需要正确地设置它，当然你要知道其中一些颇为复杂的规定。为了确保SAFEARRAY被正确地使用，它有一系列用作管理的API函数。这些API的函数负责创建、调整大小和删除SAFEARRAY。不幸的是，有关这些API函数的文档是相当少的。　　对于SAFEARRAY的内部结构我们并不关心，但了解一下是值得的。以下就是SAFEARRAY的Win32定义：　　typedef struct tagSAFEARRAY　　　{　　　　unsigned short cDims;　　　　unsigned short fFeatures;　　　　unsigned long cbElements;　　　　unsigned long cLocks;　　　　void * pvData;　　　　SAFEARRAYBOUND rgsabound[ 1 ];　　　} SAFEARRAY;　　这个结构的成员（cDims，cLocks等）是通过API函数来设置和管理的。真正的数据存放在pvData成员中，而SAFEARRAYBOUND结构定义该数组结构的细节。以下就是该结构成员的简要描述： 成员 描述 cDims 数组的维数 fFeatures 用来描述数组如何分配和如何被释放的标志 cbElements 数组元素的大小 cLocks 一个计数器，用来跟踪该数组被锁定的次数 pvData 指向数据缓冲的指针 rgsabound 描述数组每维的数组结构，该数组的大小是可变的　　rgsabound是一个有趣的成员，它的结构不太直观。它是数据范围的数组。该数组的大小依safe array维数的不同而有所区别。rgsabound成员是一个SAFEARRAYBOUND结构的数组--每个元素代表SAFEARRAY的一个维。　　typedef struct tagSAFEARRAYBOUND　　　{　　　　unsigned long cElements;　　　　unsigned long lLbound;　　　} SAFEARRAYBOUND;　　维数被定义在cDims成员中。例如，一个'C'类数组的维数可以是[3][4][5]-一个三维的数组。如果我们使用一个SAFEARRAY来表示这个结构，我们定义一个有三个元素的rgsabound数组--一个代表一维。　　cDims = 3;　　　 ...　　SAFEARRAYBOUND rgsabound[ 3 ];　　rgsabound[0]元素定义第一维。在这个例子中ILBOUND元素为0，是数组的下界。cElements成员的值等于三。数组的第二维（[4]）可以被rgsabound结构的第二个元素定义。下界也可以是0，元素的个数是4，第三维也是这样。要注意，由于这是一个"C"数组，因此由0开始，对于其它语言，例如Visual Basic，或者使用一个不同的开始。该数组的详细情况如下所示： 元素 cElements ILbound rgsabound[0] 3 0 rgsabound[1] 4 0 rgsabound[2] 5 0　　关于SAFEARRAYBOUND结构其实还有很多没说的。我们将要使用的SAFEARRAY只是一个简单的单维字节数组。我们通过API函数创建数组的时候，SAFEARRAYBOUND将会被自动设置。只有在你需要使用复杂的多维数组的时候，你才需要操作这个结构。　　还有一个名字为cLocks的成员变量。很明显，它与时间没有任何的关系--它是一个锁的计数器。该参数是用来控制访问数组数据的。在你访问它之前，你必须锁定数据。通过跟踪该计数器，系统可以在不需要该数组时安全地删除它。共3页。 1 2 3 8 : 下载本文示例代码


使用SAFEARRAY传送对象使用SAFEARRAY传送对象使用SAFEARRAY传送对象使用SAFEARRAY传送对象使用SAFEARRAY传送对象使用SAFEARRAY传送对象使用SAFEARRAY传送对象使用SAFEARRAY传送对象使用SAFEARRAY传送对象使用SAFEARRAY传送对象使用SAFEARRAY传送对象使用SAFEARRAY传送对象使用SAFEARRAY传送对象使用SAFEARRAY传送对象使用SAFEARRAY传送对象