Fungsi OleCreateLink (ole2.h)

Artikel
08/25/2023

Membuat objek tertaut dokumen campuran OLE.

Sintaks

HRESULT OleCreateLink(
  [in]  LPMONIKER       pmkLinkSrc,
  [in]  REFIID          riid,
  [in]  DWORD           renderopt,
  [in]  LPFORMATETC     lpFormatEtc,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

Parameter

[in] pmkLinkSrc

Arahkan ke antarmuka IMoniker pada moniker yang dapat digunakan untuk menemukan sumber objek yang ditautkan.

[in] riid

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

[in] renderopt

Menentukan nilai dari enumerasi OLERENDER yang menunjukkan kemampuan gambar atau pengambilan data yang baru dibuat secara lokal. Pertimbangan tambahan dijelaskan di bagian Keterangan di bawah ini.

[in] lpFormatEtc

Penunjuk 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 lpFormatEtc .

[in] pClientSite

Pointer 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.

Menampilkan nilai

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

Menampilkan kode	Deskripsi
OLE_E_CANT_BINDTOSOURCE	Tidak dapat mengikat ke sumber.

Keterangan

Panggil OleCreateLink untuk mengizinkan kontainer membuat tautan ke objek.

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	ole2.h
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

IOleClientSite::GetMoniker

IOleObject::SetMoniker