Compartilhar via


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

Verifica se um objeto está atualizado.

Sintaxe

HRESULT IsUpToDate();

Retornar valor

Esse método retornará S_OK se o objeto estiver atualizado; caso contrário, S_FALSE. Outros valores retornados possíveis incluem o seguinte.

Código de retorno Descrição
OLE_E_UNAVAILABLE
O status do objeto não pode ser determinado em tempo hábil.

Comentários

O método IOleObject::IsUpToDate fornece uma maneira de os contêineres marcar recursivamente se todos os objetos estão atualizados. Ou seja, quando o contêiner chama esse método no primeiro objeto, o objeto, por sua vez, chama-o para todos os seus próprios objetos e, por sua vez, para todos os deles, até que todos os objetos tenham sido verificados.

Anotações aos implementadores

Devido à natureza recursiva de IOleObject::IsUpToDate, determinar se um objeto está desatualizado, particularmente um que contém um ou mais outros objetos, pode ser tão demorado quanto simplesmente atualizar o objeto em primeiro lugar. Se preferir evitar consultas demoradas desse tipo, verifique se IOleObject::IsUpToDate retorna OLE_E_UNAVAILABLE. Nos casos em que o objeto a ser consultado é pequeno e não contém nenhum objeto em si, tornando possível uma consulta eficiente, esse método pode retornar S_OK ou S_FALSE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho oleidl.h

Confira também

Ioleobject

IOleObject::Update