Metode IOleObject::IsUpToDate (oleidl.h)

Memeriksa apakah objek sudah diperbarui.

Sintaks

HRESULT IsUpToDate();

Mengembalikan nilai

Metode ini mengembalikan S_OK jika objek sudah diperbarui; jika tidak, S_FALSE. Nilai pengembalian lain yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
OLE_E_UNAVAILABLE	Status objek tidak dapat ditentukan tepat waktu.

Keterangan

Metode IOleObject::IsUpToDate menyediakan cara bagi kontainer untuk memeriksa secara rekursif apakah semua objek sudah diperbarui. Artinya, ketika kontainer memanggil metode ini pada objek pertama, objek pada gilirannya memanggilnya untuk semua objeknya sendiri, dan mereka pada gilirannya untuk semua objek mereka, sampai semua objek telah diperiksa.

Catatan untuk Pelaksana

Karena sifat rekursif IOleObject::IsUpToDate, menentukan apakah objek sudah kedaluarsa, terutama objek yang berisi satu atau beberapa objek lain, dapat memakan waktu hanya dengan memperbarui objek di tempat pertama. Jika Anda lebih suka menghindari kueri panjang dari jenis ini, pastikan bahwa IOleObject::IsUpToDate mengembalikan OLE_E_UNAVAILABLE. Dalam kasus di mana objek yang akan dikueri kecil dan tidak berisi objek itu sendiri, sehingga membuat kueri yang efisien mungkin, metode ini dapat mengembalikan S_OK atau S_FALSE.

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

IOleObject

IOleObject::Update