關于SafeArray的使用說明

    猛料資料，首先介紹SafeArray使用,，在介紹SafeArray中的結構,。看完該節(jié)文章,，SafeArray的陌生感一掃而去,。

    SafeArray 在ADO編程中經(jīng)常使用。它的主要目的是用于automation中的數(shù)組型參數(shù)的傳遞,。因為在網(wǎng)絡環(huán)境中,，數(shù)組是不能直接傳遞的，而必須將其包裝成 SafeArray,。實質(zhì)上SafeArray就是將通常的數(shù)組增加一個描述符,，說明其維數(shù)、長度,、邊界、元素類型等信息,。SafeArray也并不單獨使用,，而是將其再包裝到VARIANT類型的變量中，然后才作為參數(shù)傳送出去,。在VARIANT的vt成員的值如果包含VT_ARRAY|...,那么它所封裝的就是一個SafeArray,，它的parray成員即是指向SafeArray的指針。SafeArray中元素的類型可以是VARIANT能封裝的任何類型,，包括VARIANT類型本身,。 

使用SafeArray的具體步驟：

方法一：

 包裝一個SafeArray：

(1)定義變量，如：

   VARIANT varChunk;

   SAFEARRAY *psa;

   SAFEARRAYBOUND rgsabound[1];

(2) 創(chuàng)建SafeArray描述符：

 //read array from a file.

 uIsRead=f.Read(bVal,ChunkSize);

 if(uIsRead==0)

break;

 rgsabound[0].cElements = uIsRead;

 rgsabound[0].lLbound = 0;

 psa = SafeArrayCreate(VT_UI1,1,rgsabound);

(3)放置數(shù)據(jù)元素到SafeArray：

 for(long index=0;index<uIsRead;index++)         

 {

    if(FAILED(SafeArrayPutElement(psa,&index,&bVal[index])))

    ::MessageBox(NULL,"出毛病了,。","提示",MB_OK | MB_ICONWARNING);

  }

 一個一個地放,，挺麻煩的。

(4)封裝到VARIANT內(nèi)：

   varChunk.vt = VT_ARRAY|VT_UI1;

   varChunk.parray = psa;

 這樣就可以將varChunk作為參數(shù)傳送出去了,。

讀取SafeArray中的數(shù)據(jù)的步驟：

(1)用SafeArrayGetElement一個一個地讀

 BYTE buf[lIsRead];

 for(long index=0; index<lIsRead; index++)        

 {          

    ::SafeArrayGetElement(varChunk.parray,&index,buf+index);  

 }

 就讀到緩沖區(qū)buf里了,。

方法二：

 使用SafeArrayAccessData直接讀寫SafeArray的緩沖區(qū)：

(1)讀緩沖區(qū)：

 BYTE *buf;

 SafeArrayAccessData(varChunk.parray, (void **)&buf);

 f.Write(buf,lIsRead);

 SafeArrayUnaccessData(varChunk.parray);

(2)寫緩沖區(qū)：

 BYTE *buf;

 ::SafeArrayAccessData(psa, (void **)&buf);

 for(long index=0;index<uIsRead;index++)         

 {

     buf[index]=bVal[index]; 

 }

 ::SafeArrayUnaccessData(psa);

 varChunk.vt = VT_ARRAY|VT_UI1;

 varChunk.parray = psa;

    這種方法讀寫SafeArray都可以，它直接操縱SafeArray的數(shù)據(jù)緩沖區(qū),，比用SafeArrayGetElement和 SafeArrayPutElement速度快,。特別適合于讀取數(shù)據(jù),。但用完之后不要忘了調(diào)用::SafeArrayUnaccessData (psa)，否則會出錯的,。

以下就是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函數(shù)來設置和管理的。真正的數(shù)據(jù)存放在pvData成員中,，而SAFEARRAYBOUND結構定義該數(shù)組結構的細節(jié),。以下就是該結構成員的簡要描述：

　rgsabound是一個有趣的成員,，它的結構不太直觀。它是數(shù)據(jù)范圍的數(shù)組,。該數(shù)組的大小依safe array維數(shù)的不同而有所區(qū)別,。rgsabound成員是一個SAFEARRAYBOUND結構的數(shù)組--每個元素代表SAFEARRAY的一個維。

　　typedef struct tagSAFEARRAYBOUND

　　　{

　　　　unsigned long cElements;

　　　　unsigned long lLbound;

　　　} SAFEARRAYBOUND;

　　維數(shù)被定義在cDims成員中。例如,，一個\'C\'類數(shù)組的維數(shù)可以是[3][4][5]-一個三維的數(shù)組,。如果我們使用一個SAFEARRAY來表示這個結構，我們定義一個有三個元素的rgsabound數(shù)組--一個代表一維,。

　　cDims = 3;

　　　 ...

　　SAFEARRAYBOUND rgsabound[3];

 　rgsabound[0]元素定義第一維。在這個例子中ILBOUND元素為0,，是數(shù)組的下界,。cElements成員的值等于三。數(shù)組的第二維 （[4]）可以被rgsabound結構的第二個元素定義,。下界也可以是0,，元素的個數(shù)是4，第三維也是這樣,。

   要注意,，由于這是一個"C"數(shù)組，因此由0 開始,，對于其它語言,，例如Visual Basic，或者使用一個不同的開始,。該數(shù)組的詳細情況如下所示：

  　關于SAFEARRAYBOUND結構其實還有很多沒說的,。我們將要使用的SAFEARRAY只是一個簡單的單維字節(jié)數(shù)組。我們通過API函數(shù)創(chuàng)建數(shù)組的時候,，SAFEARRAYBOUND將會被自動設置,。只有在你需要使用復雜的多維數(shù)組的時候，你才需要操作這個結構,。

　　還有一個名字為cLocks的成員變量,。很明顯,，它與時間沒有任何的關系--它是一個鎖的計數(shù)器。該參數(shù)是用來控制訪問數(shù)組數(shù)據(jù)的,。在你訪問它之前,，你必須鎖定數(shù)據(jù)。通過跟蹤該計數(shù)器,，系統(tǒng)可以在不需要該數(shù)組時安全地刪除它,。　

創(chuàng)建SAFEARRAY

　　創(chuàng)建一個單維SAFEARRAY的簡單方法是通過使用SafeArrayCreateVector API函數(shù),。該函數(shù)可分配一個特定大小的連續(xù)內(nèi)存塊,。

　　SAFEARRAY *psa;

　　//  create a safe array to store the stream data

　　//  llen is the number of bytes in the array.

　　psa = SafeArrayCreateVector( VT_UI1, 0, llen );

　 　SafeArrayCreateVector API創(chuàng)建一個SAFEARRAY，并且返回一個指向它的指針,。首個參數(shù)用來定義數(shù)組的類型--它可以是任何有效的變量數(shù)據(jù)類型,。為了傳送一個串行化的對 象，我們將使用最基本的類型--一個非負的字節(jié)數(shù)組,。VT--UI1代表非負整形的變量類型,，1個字節(jié)。

　　常數(shù)\'0\'定義數(shù)組的下界,；在C++中,，通常為0。最后的參數(shù)llen定義數(shù)組元素的個數(shù),。在我們的例子中,，這與我們將要傳送對象的字節(jié)數(shù)是一樣的。我們還沒有提數(shù)組大?。╨len）是怎樣來的,，這將在我們重新考查串行化時提及。

　　在你訪問SAFEARRAY數(shù)據(jù)之前,，你必須調(diào)用SafeArrayAccessData。該函數(shù)鎖定數(shù)據(jù)并且返回一個指針,。在這里,，鎖定數(shù)組意味著增加該數(shù)組的內(nèi)部計數(shù)器（cLocks）。

　　//  define a pointer to a byte array

　　unsigned char *pData = NULL;

　　SafeArrayAccessData( psa, (void**)&pData );

　　　... use the safe array

　　SafeArrayUnaccessData(psa);

　　相應用來釋放數(shù)據(jù)的函數(shù)是SafeArrayUnaccessData(),，該功能釋放該參數(shù)的計數(shù),。