IOleCacheControl::Metode OnRun (oleidl.h)

Memberi tahu cache bahwa objek sumber data telah memasuki status berjalan sehingga objek cache dapat menetapkan sink saran sesuai kebutuhan.

Sintaks

HRESULT OnRun(
  [in] LPDATAOBJECT pDataObject
);

Parameter

[in] pDataObject

Penunjuk ke antarmuka IDataObject pada objek yang memasuki status berjalan.

Nilai kembali

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

Menampilkan kode	Deskripsi
E_INVALIDARG	Salah satu argumen tidak valid.
E_UNEXPECTED	Terjadi kesalahan tidak terduga.
E_OUTOFMEMORY	Memori tidak cukup tersedia untuk operasi ini.

Keterangan

Ketika OnRun dipanggil, cache menyiapkan koneksi penasihat seperlunya dengan objek data sumber sehingga dapat menerima pemberitahuan. Koneksi saran yang dibuat antara objek yang sedang berjalan dan cache dihancurkan ketika IOleCacheControl::OnStop dipanggil .

Beberapa handler objek atau server dalam proses mungkin menggunakan cache secara pasif, dan tidak memanggil OnRun. Aplikasi ini harus memanggil IOleCache2::UpdateCache, IOleCache::InitCache, atau IOleCache::SetData untuk mengisi cache bila perlu untuk memastikan bahwa cache diperbarui.

OnRun tidak menambahkan jumlah referensi pada pointer ke IDataObject yang diteruskan dalam pDataObject. Karena merupakan tanggung jawab pemanggil OleRun untuk memastikan bahwa masa pakai penunjuk pDataObject berlangsung hingga OnStop dipanggil , penelepon harus memegang pointer ke IDataObject pada objek data yang diminati.

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	oleidl.h

Lihat juga

IOleCache2::UpdateCache

IOleCacheControl

IOleCacheControl::OnStop