Compartilhar via


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

Atualizações dados de um manipulador de objetos ou de um objeto de link ou caches de exibição.

Sintaxe

HRESULT Update();

Retornar valor

Esse método retorna S_OK em caso de êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno Descrição
E_FAIL
Falha na operação.
OLE_E_CANT_BINDTOSOURCE
Não é possível executar o objeto para obter dados atualizados. O objeto é, por algum motivo, indisponível para o chamador.
CACHE_E_NOCACHE_UPDATED
Nenhum cache foi atualizado.
CACHE_S_SOMECACHES_NOTUPDATED
Alguns caches não foram atualizados.

Comentários

O método Update fornece uma maneira para os contêineres manterem os dados atualizados em seus objetos vinculados e inseridos. Um objeto de link poderá ficar desatualizado se a origem do link tiver sido atualizada. Um objeto inserido que contém links para outros objetos também pode ficar desatualizado. Um objeto inserido que não contém links não pode ficar desatualizado porque seus dados não estão vinculados a outra fonte.

Observações aos implementadores

Quando um contêiner chama o método IOleObject::Update de um objeto de link, o objeto link localiza a origem do link e obtém uma nova apresentação dele. Esse processo também pode envolver a execução de um ou mais aplicativos de objeto, o que pode ser demorado.

Quando um contêiner chama o método IOleObject::Update de um objeto inserido, ele está solicitando que o objeto atualize todos os objetos de link que ele possa conter. Em resposta, o manipulador de objetos chama recursivamente IOleObject::Update para cada um de seus próprios objetos vinculados, executando cada um conforme necessário.

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