Fungsi OleCreateLinkFromData (ole2.h)

Artikel
03/15/2023

Membuat objek tertaut dari objek transfer data yang diambil baik dari clipboard atau sebagai bagian dari operasi seret dan letakkan OLE.

Sintaks

HRESULT OleCreateLinkFromData(
  [in]  LPDATAOBJECT    pSrcDataObj,
  [in]  REFIID          riid,
  [in]  DWORD           renderopt,
  [in]  LPFORMATETC     pFormatEtc,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

Parameter

[in] pSrcDataObj

Penunjuk ke antarmuka IDataObject pada objek transfer data tempat objek tertaut akan dibuat.

[in] riid

Referensi ke pengidentifikasi antarmuka yang digunakan penelepon nanti untuk berkomunikasi dengan objek baru (biasanya IID_IOleObject, yang didefinisikan dalam header OLE sebagai pengidentifikasi antarmuka untuk IOleObject).

[in] renderopt

Nilai dari enumerasi OLERENDER yang menunjukkan kemampuan gambar atau pengambilan data yang baru dibuat secara lokal adalah memiliki objek yang baru dibuat. Pertimbangan tambahan dijelaskan di bagian Keterangan berikut.

[in] pFormatEtc

Arahkan ke nilai dari enumerasi OLERENDER yang menunjukkan kemampuan gambar atau pengambilan data yang baru dibuat secara lokal. Nilai OLERENDER yang dipilih memengaruhi nilai yang mungkin untuk parameter pFormatEtc .

[in] pClientSite

Arahkan ke instans IOleClientSite, antarmuka utama tempat objek akan meminta layanan dari kontainernya. Parameter ini bisa NULL.

[in] pStg

Arahkan ke antarmuka IStorage pada objek penyimpanan. Parameter ini tidak boleh NULL.

[out] ppvObj

Alamat variabel pointer yang menerima pointer antarmuka yang diminta dalam riid. Setelah berhasil dikembalikan, ppvObj berisi penunjuk antarmuka yang diminta pada objek yang baru dibuat.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
CLIPBRD_E_CANT_OPEN	Tidak dapat membuka clipboard.
OLE_E_CANT_GETMONIKER	Tidak dapat mengekstrak moniker objek.
OLE_E_CANT_BINDTOSOURCE	Tidak dapat mengikat ke sumber. Pengikatan diperlukan untuk mendapatkan data inisialisasi cache.

Keterangan

Fungsi OleCreateLinkFromData digunakan untuk mengimplementasikan paste-link atau operasi drag-link. Operasinya mirip dengan fungsi OleCreateFromData , kecuali bahwa ia membuat tautan, dan mencari format data yang berbeda. Jika format CF_LINKSOURCE tidak ada, dan format clipboard FileName atau FileNameW ada di objek transfer data, OleCreateLinkFromData membuat paket yang berisi tautan ke file yang ditunjukkan.

Anda menggunakan parameter renderopt dan pFormatetc untuk mengontrol kemampuan penembolokan objek yang baru dibuat. Untuk informasi umum tentang cara menentukan apa yang akan di-cache, lihat enumerasi OLERENDER untuk deskripsi interaksi antara renderopt dan pFormatetc. Namun, ada beberapa efek spesifik tambahan dari parameter ini dalam perjalanan OleCreateLinkFromData menginisialisasi cache, sebagai berikut.

Nilai	Deskripsi
OLERENDER_DRAW, OLERENDER_FORMAT	Jika informasi presentasi dalam format lain dalam objek data sumber, informasi ini digunakan. Jika informasi tidak ada, cache awalnya kosong, tetapi akan diisi saat pertama kali objek dijalankan. Tidak ada format lain yang di-cache di objek yang baru dibuat.
OLERENDER_NONE, OLERENDER_ASIS	Tidak ada yang akan di-cache di objek yang baru dibuat.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	ole2.h
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

OleCreateLink

Bagikan melalui