歡迎來到OLE拖放指南第二部分；本部分的目的在于解釋在OLE環境中，程序之間怎么樣表示和傳輸數據。
OLE數據傳輸的核心是IDataObject COM接口，一個IDataObject提供從一個程序到另一個程序傳輸和訪問數據的方法。最通用的OLE數據傳輸是窗口粘貼板，當然也有拖放。IDataObject是一到多個數據的有效的COM包裝。
在我們調查IDataObject任何細節之前，兩個重要的數據結構你必須熟悉：FORMATETC和STGMEDIUM接口，他們用來描述和存儲OLE數據。
描述OLE數據
FORMATETC接口（發音“format et cetera”）用來表示IDataObject提供（或接收）的數據類型，是標準window粘貼板格式（CF_TEXT等）的擴展，因此除了基本的粘貼板格式之外，還包含了數據怎么樣rendered和存儲。
typedef struct
{ CLIPFORMAT cfFormat;
DVTARGETDEVICE *ptd;
DWORD dwAspect;
LONG lindex;
DWORD tymed;
} FORMATETC;
FORMATETC結構的成員如下描述：
cfFormat：粘貼板格式，用來表示FORMATETC結構。可以是內建的格式（例如：CF_TEXT或CF_BITMAP）或者用RegisterClipboardFormat注冊的自定義格式。
Ptd:指向DVTARGETDEVICE結構，提供已經rendered數據的設備信息。正常的粘貼板操作和拖放操作都是NULL。
dwAspect：描述用戶怎么樣render數據的大量細節。通常這個是DVASPECT_CONTECT，表示全內容，但也可以描述較少的信息，例如：圖標。
Lindex：僅僅在當數據通過頁面邊界被分割的時候使用，它不用于簡單的OLE傳輸，因此該值幾乎總是-1。
Typemed：這是一個有趣的成員；因為其描述了用于存儲數據的存儲媒體類型。該成員名字自詞組“Type of Medium”；該值在window.h中定義的TYMED_XXX等值。
因此有了這個數據結構，OLE已經提供了一個描述消費者什么樣的數據已經怎么樣render這個數據。
存儲OLE數據
結構體STGMEDIUM(STORAGE MEDIUM的縮寫)提供一個用來存儲數據的容器，因此叫存儲媒體：
typedef struct
{ DWORD tymed;
union
{ HBITMAP hBitmap;
HMETAFILEPICT hMetaFilePict;
HENHMETAFILE hEnhMetaFile;
HGLOBAL hGlobal;
LPWSTR lpszFileName;
IStream *pstm;
IStorage *pstg;
};
IUnknown *pUnkForRelease;
} STGMEDIUM;
這個結構定義看起來比較復雜，但是有用的僅僅三個成員，因為未命名聯合合并了所有內容作為一個實體共享同樣的存儲空間。
1. tymed：這個成員必須和FORMATETC結構相同，這個成員指定已經存儲的媒體類型，例如，全局數據（TYMED_HGLOBAL），IStream（TYPED_ISTREAM）等等。相應的聯合中的元素是數據的句柄。
2. hBitmap/hGlobal等：實際的數據，僅僅他們中的一個是有效的，這依賴于tymed的值。
3. pUnkForRelease：一個可選的指針，指向IUnknown接口，數據的接收方應該調用其Release方法。當這個字段是NULL時，接收方有責任釋放內存句柄。ReleaseStgMedium API調用在這里非常有用，它負責釋放STGMEDIUMS的數據內容，因此實際上我們不需要做什么。
STGMEDIUM結構是傳統的windows HGLOBAL內存句柄的擴展，同時支持HGLOBAL（且一直是最常用的），同時支持許多其他的類型，最有用的是IStream和IStorage通用COM接口。
總之，結構體FORMATETC和STGMEDIUM一起用來描述和存儲OLE數據實體的。FORMATETC通常用來從IDataObject請求指定類型的數據，同時STGMEDIUM結構用來接收和保存請求的數據。
傳輸OLE數據
IDataObject接口提供了從一個程序到另一個程序傳遞數據的方法，IDataObject在兩個情況下非常有用：粘貼板和拖放。如果設計精細，可以用一個COM對象來同時實現粘貼板和拖放操作。
下面的表列出了IDataObject成員函數，按照他們在接口虛表中出現的順序。為了簡化的原因，IUnknown方法（AddRef，Release和QueryInterface）沒有列出。
|
IDataObject方法 |
描述 |
|
GetData |
Render在FORMATETC結構體中描述的數據，并通過STGMEDIUM結構體來傳遞數據 |
|
GetDataHere |
Render在FORMATETC結構體中的數據，并通過調用者分配的STGMEDIUM結構體傳輸數據。 |
|
QueryGetData |
判斷數據對象是否可以render在FORMATETC結構中描述的數據 |
|
GetCanonicalFormatEtc |
提供一個潛在不同的但邏輯上相同的FORMATETC結構體。 |
|
SetData |
提供一個通過FORMATECT結構和STGMEDIUM結構描述的源數據對象。 |
|
EnumFormatEtc |
創建并返回一個IEnumFORMATETC接口的指針來枚舉數據對象支持的FORMATETC對象。 |
|
DAdvise |
創建一個在數據對象和通知接收器之間的連接，因此通知接收器能接收到數據對象中通知的改變。 |
|
DUnadvise |
銷毀一個前面使用DAdvise方法安裝的通知 |
|
EnumDAdvise |
創建和返回一個指向枚舉當前通知連接的接口指針。 |
這個表看起來很漂亮，我們也看到EnumFormatEtc方法并發現我們不得不同時實現IEnumFORMATETC接口，它有13個成員函數，不包括IUnknown方法，到這里我們還沒有考慮IDropSource和IDropTarget。
慶幸的是，為了簡化OLE拖放，我們僅僅需要實現GetData、QueryGetData和EnumFormatEtc，因此這節省了我們許多工作。
使用IDataObject來訪問粘貼板
為了使在我們的OLE旅程中放松一下，下面我們來看一個簡單的通過OLE來訪問粘貼板的例子：
WINOLEAPI OleGetClipboard(IDataObject ** ppDataObj);
這個簡單的Windows API調用用來返回一個IDataObject，它提供用來一個干凈地訪問WINDOWS粘貼板內容的好接口。注意，我們在本例中不需要實現IDataObject接口，我們僅僅需要知道接口怎么樣工作的，一個簡單的訪問粘貼板內容的程序如下：
#include <windows.h>
int main(void)
{ IDataObject *pDataObject;
if(OleInitialize(0) != S_OK)
return 0;
if(OleGetClipboard(&pDataObject) == S_OK)
{
DisplayDataObject (pDataObject);
pDataObject->Release();
}
OleUninitialize();
return 0;
}
OLE API調用非常簡單，且它是直接來訪問IDataObject對象：
void DisplayDataObject(IDataObject *pDataObject)
{ FORMATETC fmtetc = { CF_TEXT, 0, DVASPECT_CONTENT, -1, TYMED_HGLOBAL }; STGMEDIUM stgmed;
if(pDataObject->GetData(&fmtetc, &stgmed) == S_OK)
{
char *data = GlobalLock(stgmed.hGlobal);
printf("%s\n", data);
GlobalUnlock(stgmed.hGlobal);
ReleaseStgMedium(&stgmed);
}
}
上面的代碼演示了最常用的訪問IDataObject的方法，數據通過調用IDataObject::GetData來請求，我們構造一個FORMATETC對象，它指定了我們想要訪問的數據的類型，在這個例子中，標準的CF_TEXT數據緩沖區以HGLOBAL內存對象來存儲。
數據返回到我們提供的STGMEDIUM結構體中，一旦我們鎖定并顯示數據，清理和調用標準的ReleaseStgMedium API來釋放存儲在STGMEDIUM結構中的數據就簡單了。
注意，代碼中僅僅當文本被選擇到粘貼板的時候才工作，也就是說，如果沒有CF_TEXT被存儲到粘貼板，粘貼板的IDataObject::GetData程序調用會失敗，我們什么也不打印。