Fungsi OleCreateFromFile (ole2.h)

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.

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

Lihat juga

GetClassFile