Fungsi OleCreateFromFile (ole2.h)

Artikel
08/25/2023

Membuat objek yang disematkan dari konten file bernama.

Sintaks

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

Parameter

[in] rclsid

Parameter ini dicadangkan dan harus CLSID_NULL.

[in] lpszFileName

Penunjuk ke string yang menentukan jalur lengkap file tempat objek harus diinisialisasi.

[in] riid

Referensi ke pengidentifikasi antarmuka yang kemudian digunakan pemanggil untuk berkomunikasi dengan objek baru (biasanya IID_IOleObject, yang didefinisikan dalam header OLE sebagai ID antarmuka 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. Nilai OLERENDER yang dipilih memengaruhi nilai yang mungkin untuk parameter lpFormatEtc .

[in] lpFormatEtc

Bergantung pada bendera OLERENDER mana yang digunakan sebagai nilai renderopt, penunjuk ke salah satu nilai enumerasi FORMATETC . Lihat juga enumerasi OLERENDER untuk pembatasan.

[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 kembali, *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
STG_E_FILENOTFOUND	File tidak terikat.
OLE_E_CANT_BINDTOSOURCE	Tidak dapat mengikat ke sumber.
STG_E_MEDIUMFULL	Medium penuh.
DV_E_TYMED	TYMED tidak valid.
DV_E_LINDEX	LINDEX tidak valid.
DV_E_FORMATETC	Struktur FORMATETC tidak valid.

Keterangan

Fungsi OleCreateFromFile membuat objek baru yang disematkan dari konten file bernama. Jika ProgID dalam database pendaftaran berisi kunci PackageOnFileDrop, progID akan membuat paket. Jika tidak, fungsi memanggil fungsi GetClassFile untuk mendapatkan CLSID yang terkait dengan parameter lpszFileName , lalu membuat objek yang disematkan OLE 2 yang terkait dengan CLSID tersebut. Parameter rclsidOleCreateFromFile akan selalu diabaikan, dan harus diatur ke CLSID_NULL.

Adapun fungsi OleCreateXxx lainnya, objek yang baru dibuat tidak ditampilkan kepada pengguna untuk pengeditan, yang memerlukan operasi DoVerb . Ini digunakan untuk menerapkan operasi sisipkan file.

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 (termasuk Ole2.h)
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

GetClassFile

Share via