IOleObject::IsUpToDate 方法 (oleidl.h)
檢查物件是否為最新狀態。
Syntax
HRESULT IsUpToDate();
傳回值
如果物件是最新的,這個方法會傳回S_OK;否則,S_FALSE。 其他可能的傳回值包括下列專案。
傳回碼 | Description |
---|---|
|
無法及時判斷物件的狀態。 |
備註
IOleObject::IsUpToDate 方法提供一種方式,讓容器以遞歸方式檢查所有物件是否為最新狀態。 也就是說,當容器在第一個物件上呼叫這個方法時,對象會接著針對其所有物件呼叫此方法,然後針對其所有物件呼叫此方法,直到檢查所有物件為止。
實作者的注意事項
由於 IOleObject::IsUpToDate 的遞歸本質,因此判斷物件是否過期,特別是包含一個或多個其他對象的物件,可以像第一次更新對象一樣耗時。 如果您想要避免此類型的冗長查詢,請確定 IOleObject::IsUpToDate 會傳回OLE_E_UNAVAILABLE。 如果要查詢的物件很小,而且不包含任何物件本身,因此可以有效率的查詢,這個方法可以傳回S_OK或S_FALSE。規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | oleidl.h |