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 |
|---|---|
|
Salah satu argumen tidak valid. |
|
Terjadi kesalahan tidak terduga. |
|
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 |