結構或大內存塊打包的辦法
Revision History:
Version Date Creator Description
Implementation Scope：
繼續閱讀之前，我們假設您熟悉以下知識：
- SAFEARRAY
- ISTREAM
- Microsoft MSMQ
目錄：
1:概述
2:借用SAFEARRAY打包把結構寫入MSMQ隊列
3:借用IStream流打包傳遞數據到MSMQ隊列
1.概述
通常我們建議通過MSMQ傳遞基于XML的字符串，但有時候也需要傳遞一些結構或者一些接口指針，那么如何打包傳遞呢？
這實際上可以轉換為一個普適問題：
如何把一個結構體(structure object)或者巨大內存塊（比如5MB左右）打包為PROPVARIANT-compatible的類型？
首先，IMSMQMessagePtr的Body屬性接收_variant_t參數:
inline void IMSMQMessage::PutBody ( const _variant_t & pvarBody ) {
HRESULT _hr = put_Body(pvarBody);
if (FAILED(_hr)) _com_issue_errorex(_hr, this, __uuidof(this));
}
如果我們想把結構作為消息的Body寫入MSMQ消息隊列，我們需要把我們的結構、大內存塊或接口指針轉換為_variant_t。
2.借用SAFEARRAY打包把結構寫入MSMQ隊列
把一個結構體打包為PROPVARIANT-compatible的類型，需要用到SAFEARRAY，一個帶有邊界信息的數組。這是一個常用技巧，很多文章都有提及，我就不多解釋了。
但是，注意這種方式一次只能打包65536字節以下的數據，這是由于
SAFEARRAY* SafeArrayCreateVector(
VARTYPE vt,
long lLbound,
unsigned int cElements);
的定義所限制的。
我們通常會用SafeArrayCreateVector API創建一個單維SAFEARRAY，分配一個sizeof(_DATA)大小的連續內存塊，而這個函數的第三個參數是一個unsigned int類型，所以最大值就只能是65536了。
更多SAFEARRAY知識，參見使用SAFEARRAY傳遞對象。
2.借用SAFEARRAY打包把結構寫入MSMQ隊列
續上1.1篇的打包步驟（VC++代碼）：
// ChangeStruct2Var函數的定義：
// 第一個參數：
// 類型：CComVariant
// 作用：接收者
// 第二個參數：
// 類型：_DATA*
// 作用：源
HRESULT ChangeStruct2Variant (CComVariant &var, _DATA *pData)
{
HRESULT hr = S_OK;
// 使用SafeArrayCreateVector API創建一個單維SAFEARRAY，分配一個sizeof(_DATA)大小的連續內存塊
// VT--UI1代表非負整形的變量類型，1個字節
// 常數'0'定義數組的下界
LPSAFEARRAY lpsa = SafeArrayCreateVector(VT_UI1, 0, sizeof(_DATA));
LPBYTE pbData = NULL;
if (lpsa)
{
//在你訪問SAFEARRAY數據之前，你必須調用SafeArrayAccessData。該函數鎖定數據并且返回一個指針。在這里，鎖定數組意味著增加該數組的內部計數器（cLocks）
hr = SafeArrayAccessData(lpsa, (void **)&pbData);
}
else
hr = HRESULT_FROM_WIN32(GetLastError());
if (SUCCEEDED(hr))
{
// 使用safe array：
// 將傳入的_DATA指針指向的內存復制到pbData
CopyMemory(pbData, pData, sizeof(*pData));
// 設置var的類型為數組
var.vt = VT_ARRAYVT_UI1;
// 將var和我們的單維SAFEARRAY拉上關系：
var.parray = lpsa;
}
if (pbData)
{
//相應用來釋放數據的函數是SafeArrayUnaccessData()，該功能釋放該參數的計數。
SafeArrayUnaccessData(var.parray);
}
if (FAILED(hr))
{
// 銷毀SAFEARRAY
SafeArrayDestroy(lpsa);
}
return hr;
}
////////////////////////////////////////////////////////////
//Added Headers:
////////////////////////////////////////////////////////////
#include <comdef.h>
#include <atlbase.h>
///////////////////////////////////////////////////////////
//Added for MSMQ:
///////////////////////////////////////////////////////////
#import "mqoa.dll" no_namespace, named_guids
typedef struct _DATA
{
int _n;
char _str;
}_DATA;
//main:
{
.. ..
.. ..
IMSMQMessagePtr pisMsg = NULL;
hr = pisMsg.CreateInstance("MSMQ.MSMQMessage");
_DATA msg;
msg._n = 1;
msg._str = '1';
CComVariant var;
// 打包函數：
ChangeStruct2Variant(var, &msg);
// 打包后的CComVariant傳遞給MSMQMessege的Body屬性：
pisMsg->Body= var;
pisMsg->AppSpecific=-1;
// 發送到消息隊列：
pisMsg->Send(pisQueue);
.. ..
}
這樣，就可以成功地把一個結構遞交到MSMQ隊列中了。
Implementation Scope：
繼續閱讀之前，我們假設您熟悉以下知識：
- SAFEARRAY
- ISTREAM
- Microsoft MSMQ
目錄：
1:概述
2:借用SAFEARRAY打包把結構寫入MSMQ隊列
3:借用IStream流打包傳遞數據到MSMQ隊列
下面給出讀取MSMQ消息時解析的步驟（VC++代碼）：
////////////////////////////////////////////////////////////
//Added Headers:
////////////////////////////////////////////////////////////
#include <comdef.h>
#include <atlbase.h>
///////////////////////////////////////////////////////////
//Added for MSMQ:
///////////////////////////////////////////////////////////
#import "mqoa.dll" no_namespace, named_guids
typedef struct _DATA
{
int _n;
char _str;
}_DATA;
//main:
{
.. ..
.. ..
hr = pisQI->raw_Open(MQ_PEEK_ACCESS,MQ_DENY_NONE,&pisQueue);
IMSMQMessagePtr piMessage;
// 獲取MSMQ隊列中的一個消息：
piMessage = pisQueue->PeekCurrent();
_DATA *msg = new _DATA();
// 解析函數：
ChangeVariant2Struct(CComVariant(piMessage->Body), msg);
.. ..
}
// ChangeVariant2Struct函數的定義：
// 第一個參數：
// 類型：CComVariant
// 作用：源
// 第二個參數：
// 類型：_DATA*
// 作用：接收者
HRESULT ChangeVariant2Struct (CComVariant &var, _DATA *DP)
{
SAFEARRAY* psa;
BYTE HUGEP *lpb;
psa = var.parray;
SafeArrayAccessData(psa, (void HUGEP **)&lpb);
CopyMemory((LPVOID)DP, (LPVOID)lpb, 8);
SafeArrayUnaccessData(psa);
return S_OK;
}
Writen by zhengyun.NoJunk(at)tomosoft.dot.com
Disclaimers：
本文檔僅供參考。本文檔所包含的信息代表了在發布之日，zhengyun對所討論問題的當前看法，zhengyun不保證所給信息在發布之日以后的準確性。
用戶應清楚本文檔的準確性及其使用可能帶來的全部風險。可以復制和傳播本文檔，但須遵守以下條款：
復制時不得修改原文，復制內容須包含所有頁 ；
所有副本均須含有 zhengyun的版權聲明以及所提供的其它聲明 ；
Implementation Scope：
繼續閱讀之前，我們假設您熟悉以下知識：
- SAFEARRAY
- ISTREAM
- Microsoft MSMQ
目錄：
1:概述
2:借用SAFEARRAY打包把結構寫入MSMQ隊列
3:借用IStream流打包傳遞數據到MSMQ隊列
3.借用IStream流傳遞數據
正如前面所述，當你有一塊非常巨大的數據要傳遞給MSMQ隊列時，而且你希望一次液壓成型，那么把它打包入IStream流，也是一個很常用技巧，了解COM的人都知道，我也不多解釋了。
我們研究了ATL中IPersistMemoryImpl接口Load方法的實現機理，來做我們的事情：
// 函數名：LoadStreamOnHugeMemory
// 功能： 同上
// 第一個參數pvMem指向一塊要打包的內存，第二個參數指明這塊內存的大小
HRESULT LoadStreamOnHugeMemory(void pvMem, ULONG cbSize)
{
// Get Memory Handle:
HGLOBAL h = GlobalAlloc(GMEM_MOVEABLE, cbSize);
If(NULL == h) return E_OUTOFMEMORY;
LPVOID pv = GlobalLock(h);
If(!pv) return E_OUTOFMEMORY;
// Copy to memory block
CopyMemory(pv, pvMem, cbSize);
CComPtr<IStream> spStream;
// Create stream on Memory:
HRESULT hr = CreateStreamOHGlobal(h, TRUE, &spStream);
If(FAILED(hr))
{
GlobalUnlock(h);
GlobalFree(h);
return hr;
}
// stream now owns the memory
// unlock the data
GlobalUnlock(hGlobal);
// Create a stream holder. Load the stream holder from the global stream.
// THIS STREAM HOLDER IS INTERITED FROM IPersistStream
// And all virtual functions are Modified to handle the object....
CComPtr <IStreamHolder> pHolder = new CComObject <CStreamHolder>;
CComPtr <IPersistStream> pHolderStream;
hr = pHolder->QueryInterface (IID_IPersistStream, (void **)&pHolderStream);
pStream->Seek( zero, STREAM_SEEK_SET, NULL );
pHolderStream->Load(pStream);
CComVariant vComData = pHolder;
.. ..
//
// now, you have a big chunk of memory loaded into a ComVariant
//
// 現在你可以把打包后的CComVariant傳遞給MSMQMessege的Body屬性了：
pisMsg->Body = vComData;
.. ..
}
其實，Aydin的實現和ATL中IPersistMemoryImpl接口Load方法實現異曲同工。我們不妨換一種方式實現。
Writen by zhengyun.NoJunk(at)tomosoft.dot.com
Disclaimers：
本文檔僅供參考。本文檔所包含的信息代表了在發布之日，zhengyun對所討論問題的當前看法，zhengyun不保證所給信息在發布之日以后的準確性。
用戶應清楚本文檔的準確性及其使用可能帶來的全部風險。可以復制和傳播本文檔，但須遵守以下條款：
復制時不得修改原文，復制內容須包含所有頁 ；
所有副本均須含有 zhengyun的版權聲明以及所提供的其它聲明 ；
不得以贏利為目的對本文檔進行傳播 。
Implementation Scope：
繼續閱讀之前，我們假設您熟悉以下知識：
- SAFEARRAY
- ISTREAM
- Microsoft MSMQ
目錄：
1:概述
2:借用SAFEARRAY打包把結構寫入MSMQ隊列
3:借用IStream流打包傳遞數據到MSMQ隊列
其實，Aydin的實現和ATL中IPersistMemoryImpl接口Load方法實現異曲同工。我們不妨換一種方式實現。
Aydin給出的VC++代碼是：
// 智能流指針
CComPtr<IStream> pStream = NULL;
LARGE_INTEGER zero = {0,0};
// hGlobal是內存句柄：
LPBYTE pChunk = (BYTE *) GlobalLock(hGlobal);
// 創建一個空的stream：
HRESULT hr = CreateStreamOnHGlobal(NULL, TRUE, &pStream );
pStream->Seek( zero, STREAM_SEEK_SET, NULL );
ULONG pcbWritten = 0;
// pChunk現在已經指向我們的巨大內存塊；
// 我們把這塊內存寫入IStream流中：
pStream->Write (pChunk, dwNumRead, &pcbWritten);
// 檢查是否全部寫入了：
ATLASSERT(pcbWritten==dwNumRead);
// unlock the data
GlobalUnlock(hGlobal);
// 剩下的一樣，也是讓CComPtr <IPersistStream>來調用Load方法加載IStream
// Create a stream holder. Load the stream holder from the global stream.
// THIS STREAM HOLDER IS INTERITED FROM IPersistStream
// And all virtual functions are Modified to handle the object....
CComPtr <IStreamHolder> pHolder = new CComObject <CStreamHolder>;
CComPtr <IPersistStream> pHolderStream;
hr = pHolder->QueryInterface (IID_IPersistStream, (void **)&pHolderStream);
pStream->Seek( zero, STREAM_SEEK_SET, NULL );
pHolderStream->Load(pStream);
CComVariant vComData = pHolder;
.. ..
//
// now, you have a big chunk of memory loaded into a ComVariant
//
// 現在你可以把打包后的CComVariant傳遞給MSMQMessege的Body屬性了：
pisMsg->Body = vComData;
.. ..
//Coder: Aydin T.BAKIR
全文完。
Writen by zhengyun.NoJunk(at)tomosoft.dot.com
Disclaimers：
本文檔僅供參考。本文檔所包含的信息代表了在發布之日，zhengyun對所討論問題的當前看法，zhengyun不保證所給信息在發布之日以后的準確性。
用戶應清楚本文檔的準確性及其使用可能帶來的全部風險。可以復制和傳播本文檔，但須遵守以下條款：
復制時不得修改原文，復制內容須包含所有頁 ；
所有副本均須含有 zhengyun的版權聲明以及所提供的其它聲明 ；
不得以贏利為目的對本文檔進行傳播 。