Fungsi OleCreateLinkToFile (ole2.h)

Artikel
08/25/2023

Membuat objek yang ditautkan ke file.

Sintaks

HRESULT OleCreateLinkToFile(
  [in]  LPCOLESTR       lpszFileName,
  [in]  REFIID          riid,
  [in]  DWORD           renderopt,
  [in]  LPFORMATETC     lpFormatEtc,
  [in]  LPOLECLIENTSITE pClientSite,
  [in]  LPSTORAGE       pStg,
  [out] LPVOID          *ppvObj
);

Parameter

[in] lpszFileName

Penunjuk ke string yang memberi nama file sumber yang akan 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

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

[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 pFormatEtc .

[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
STG_E_FILENOTFOUND	Nama file tidak valid.
OLE_E_CANT_BINDTOSOURCE	Tidak dapat mengikat ke sumber.

Keterangan

Fungsi OleCreateLinkToFile berbeda dari fungsi OleCreateLink karena dapat membuat tautan ke file yang tidak mengetahui OLE, serta yang menggunakan Windows Packager.

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

OleCreateLink