IOleObject：：GetClipboardData 方法 (oleidl.h)

發行項
08/25/2023

擷取包含呼叫這個方法之内嵌物件目前內容的資料物件。使用這個資料物件的指標，可以建立與原始資料相同的新内嵌物件。

語法

HRESULT GetClipboardData(
  [in]  DWORD       dwReserved,
  [out] IDataObject **ppDataObject
);

參數

[in] dwReserved

此參數是保留的，而且必須是零。

[out] ppDataObject

接收資料物件介面指標的 IDataObject 指標變數位址。如果發生錯誤， ppDataObject 必須設定為 Null。每次物件收到 IOleObject：：GetClipboardData的呼叫時，它必須增加 ppDataObject上的參考計數。呼叫者必須負責在ppDataObject完成時呼叫Release。

傳回值

此方法會在成功時傳回S_OK。其他可能的傳回值包括下列專案。

傳回碼	描述
E_NOTIMPL	不支援GetClipboardData。
OLE_E_NOTRUNNING	物件未執行。

備註

您可以使用 IOleObject：：GetClipboardData 方法，將連結的物件轉換成内嵌物件，在此情況下，容器應用程式會呼叫 IOleObject：：GetClipboardData ，然後將收到的資料傳遞至 OleCreateFromData。這個方法會傳回資料物件的指標，該物件與標準複製作業傳遞至剪貼簿的內容相同。

來電者的附注

如果您想要内嵌物件目前內容的穩定快照集，請呼叫 IOleObject：：GetClipboardData。如果資料變更，您必須針對更新的快照集再次呼叫函式。如果您想要讓呼叫端收到資料發生變更的通知，請呼叫 QueryInterface，然後呼叫 IDataObject：:D Advise。

實作者的注意事項

如果您實作此函式，您必須傳回資料不會變更之物件的 IDataObject 指標。

需求


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	oleidl.h