Fungsi OleCreate (ole.h)

Artikel
02/29/2024

Membuat objek tersemat yang diidentifikasi oleh CLSID. Anda biasanya menggunakannya untuk mengimplementasikan item menu yang memungkinkan pengguna akhir menyisipkan objek baru.

Sintaks

OLESTATUS OleCreate(
  LPCSTR        unnamedParam1,
  LPOLECLIENT   unnamedParam2,
  LPCSTR        unnamedParam3,
  LHCLIENTDOC   unnamedParam4,
  LPCSTR        unnamedParam5,
  LPOLEOBJECT   *unnamedParam6,
  OLEOPT_RENDER unnamedParam7,
  OLECLIPFORMAT unnamedParam8
);

Parameter

unnamedParam1

TBD

unnamedParam2

TBD

unnamedParam3

TBD

unnamedParam4

TBD

unnamedParam5

TBD

unnamedParam6

TBD

unnamedParam7

TBD

unnamedParam8

TBD

Nilai kembali

Fungsi ini mengembalikan S_OK pada keberhasilan dan mendukung nilai pengembalian standar E_OUTOFMEMORY.

Menampilkan kode	Deskripsi
E_OUTOFMEMORY	Memori untuk operasi tidak cukup.

Keterangan

Fungsi OleCreate membuat objek tersemat baru, dan biasanya dipanggil untuk mengimplementasikan item menu Sisipkan Objek Baru. Saat OleCreate kembali, objek yang dibuatnya kosong (tidak berisi data), kecuali renderopt OLERENDER_DRAW atau OLERENDER_FORMAT, dan dimuat. Kontainer biasanya kemudian memanggil fungsi OleRun atau IOleObject::D oVerb untuk menampilkan objek untuk pengeditan awal.

Parameter rclsid menentukan CLSID dari objek yang diminta. CLS objek terdaftar disimpan dalam registri sistem. Saat pengguna aplikasi memilih Sisipkan Objek, kotak pilihan memungkinkan pengguna untuk memilih jenis objek yang diinginkan dari yang ada di registri. Saat OleCreate digunakan untuk mengimplementasikan item menu Sisipkan Objek, CLSID yang terkait dengan item yang dipilih ditetapkan ke parameter rclsid OleCreate.

Parameter riid menentukan antarmuka yang akan digunakan klien untuk berkomunikasi dengan objek baru. Setelah berhasil dikembalikan, parameter ppvObject memegang pointer ke antarmuka yang diminta.

Cache objek yang dibuat berisi informasi yang memungkinkan presentasi objek yang terkandung saat kontainer dibuka. Informasi tentang apa yang harus di-cache diteruskan dalam nilai renderopt dan pFormatetc . Saat OleCreate kembali, cache objek yang dibuat belum tentu diisi. Sebaliknya, cache diisi saat pertama kali objek memasuki status berjalan. Pemanggil dapat menambahkan kontrol cache tambahan dengan panggilan ke IOleCache::Cache setelah pengembalian OleCreate dan sebelum objek dijalankan. Jika renderopt OLERENDER_DRAW atau OLERENDER_FORMAT, OleCreate mengharuskan objek mendukung antarmuka IOleCache . Tidak ada persyaratan seperti itu untuk nilai renderopt lainnya.

Jika pClientSite bukan NULL, OleCreate memanggil IOleObject::SetClientSite melalui penunjuk pClientSite . IOleClientSite adalah antarmuka utama tempat objek meminta layanan dari kontainernya. Jika pClientSiteADALAH NULL, Anda harus melakukan panggilan tertentu ke IOleObject::SetClientSite sebelum mencoba operasi apa pun.

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

Lihat juga