Metode IOleObject::GetClipboardData (oleidl.h)

Artikel
08/25/2023

Mengambil objek data yang berisi konten objek tersemat saat ini tempat metode ini dipanggil. Dengan menggunakan penunjuk ke objek data ini, dimungkinkan untuk membuat objek tersemat baru dengan data yang sama dengan aslinya.

Sintaks

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

Parameter

[in] dwReserved

Parameter ini dicadangkan dan harus nol.

[out] ppDataObject

Alamat variabel pointer IDataObject yang menerima penunjuk antarmuka ke objek data. Jika terjadi kesalahan, ppDataObject harus diatur ke NULL. Setiap kali objek menerima panggilan ke IOleObject::GetClipboardData, objek harus meningkatkan jumlah referensi pada ppDataObject. Pemanggil bertanggung jawab untuk memanggil Rilis ketika selesai dengan ppDataObject.

Mengembalikan nilai

Metode ini mengembalikan S_OK pada keberhasilan. Nilai pengembalian lain yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_NOTIMPL	GetClipboardData tidak didukung.
OLE_E_NOTRUNNING	Objek tidak berjalan.

Keterangan

Anda dapat menggunakan metode IOleObject::GetClipboardData untuk mengonversi objek tertaut ke objek yang disematkan, dalam hal ini aplikasi kontainer akan memanggil IOleObject::GetClipboardData lalu meneruskan data yang diterima ke OleCreateFromData. Metode ini mengembalikan penunjuk ke objek data yang identik dengan apa yang akan diteruskan ke clipboard oleh operasi salin standar.

Catatan untuk Penelepon

Jika Anda menginginkan rekam jepret stabil dari konten saat ini dari objek yang disematkan, panggil IOleObject::GetClipboardData. Jika data berubah, Anda harus memanggil fungsi lagi untuk rekam jepret yang diperbarui. Jika Anda ingin penelepon diberi tahu tentang perubahan yang terjadi pada data, panggil QueryInterface, lalu panggil IDataObject::D Advise.

Catatan untuk Pelaksana

Jika Anda menerapkan fungsi ini, Anda harus mengembalikan penunjuk IDataObject untuk objek yang datanya tidak akan berubah.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	oleidl.h