Метод 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
Header oleidl.h

См. также раздел

IOleObject

IOleObject::Update