IOleObject::IsUpToDate 方法 (oleidl.h)

檢查物件是否為最新狀態。

Syntax

HRESULT IsUpToDate();

傳回值

如果物件是最新的,這個方法會傳回S_OK;否則,S_FALSE。 其他可能的傳回值包括下列專案。

傳回碼 Description
OLE_E_UNAVAILABLE
無法及時判斷物件的狀態。

備註

IOleObject::IsUpToDate 方法提供一種方式,讓容器以遞歸方式檢查所有物件是否為最新狀態。 也就是說,當容器在第一個物件上呼叫這個方法時,對象會接著針對其所有物件呼叫此方法,然後針對其所有物件呼叫此方法,直到檢查所有物件為止。

實作者的注意事項

由於 IOleObject::IsUpToDate 的遞歸本質,因此判斷物件是否過期,特別是包含一個或多個其他對象的物件,可以像第一次更新對象一樣耗時。 如果您想要避免此類型的冗長查詢,請確定 IOleObject::IsUpToDate 會傳回OLE_E_UNAVAILABLE。 如果要查詢的物件很小,而且不包含任何物件本身,因此可以有效率的查詢,這個方法可以傳回S_OK或S_FALSE。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 oleidl.h

另請參閱

IOleObject

IOleObject::Update