Método IOleObject::IsUpToDate (oleidl.h)

  • Artículo

Comprueba si un objeto está actualizado.

Sintaxis

HRESULT IsUpToDate();

Valor devuelto

Este método devuelve S_OK si el objeto está actualizado; de lo contrario, S_FALSE. Otros posibles valores devueltos son los siguientes.

Código devuelto Descripción
OLE_E_UNAVAILABLE
 El estado del objeto no se puede determinar de forma oportuna.

Comentarios

El método IOleObject::IsUpToDate proporciona una manera de que los contenedores comprueben de forma recursiva si todos los objetos están actualizados. Es decir, cuando el contenedor llama a este método en el primer objeto, el objeto a su vez lo llama para todos sus propios objetos y, a su vez, para todos sus objetos, hasta que se hayan comprobado todos los objetos.

Notas para los implementadores

Debido a la naturaleza recursiva de IOleObject::IsUpToDate, determinar si un objeto está obsoleto, especialmente uno que contiene uno o varios otros objetos, puede ser tan lento como simplemente actualizar el objeto en primer lugar. Si prefiere evitar consultas largas de este tipo, asegúrese de que IOleObject::IsUpToDate devuelve OLE_E_UNAVAILABLE. En los casos en los que el objeto que se va a consultar es pequeño y no contiene ningún objeto, lo que hace posible una consulta eficaz, este método puede devolver S_OK o S_FALSE.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado oleidl.h

Consulte también

IOleObject

IOleObject::Update