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 |
---|---|
|
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 |