IOleObject::IsUpToDate 方法 (oleidl.h)

检查对象是否为最新版本。

语法

HRESULT IsUpToDate();

返回值

如果对象是最新的,则此方法返回S_OK;否则,S_FALSE。 其他可能的返回值包括以下内容。

返回代码 说明
OLE_E_UNAVAILABLE
无法及时确定对象的状态。

注解

IOleObject::IsUpToDate 方法为容器提供了一种以递归方式检查所有对象是否为最新状态的方法。 也就是说,当容器在第一个对象上调用此方法时,对象又针对其自己的所有对象调用此方法,而针对其所有对象调用此方法,直到选中所有对象为止。

实施者说明

由于 IOleObject::IsUpToDate 的递归特性,确定对象是否过期(尤其是包含一个或多个其他对象的对象)可能和首先更新对象一样耗时。 如果希望避免此类型的冗长查询,请确保 IOleObject::IsUpToDate 返回OLE_E_UNAVAILABLE。 如果要查询的对象较小且本身不包含任何对象,因此可以高效查询,此方法可以返回S_OK或S_FALSE。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 oleidl.h

另请参阅

IOleObject

IOleObject::Update