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

Artigo
03/01/2024

Atualizações os dados armazenados em cache do documento composto para um objeto vinculado. Isso envolve a associação à origem do link, se ela ainda não estiver associada.

Sintaxe

HRESULT Update(
  [in] IBindCtx *pbc
);

Parâmetros

[in] pbc

Um ponteiro para a interface IBindCtx no contexto de associação a ser usado na associação da origem do link. Este parâmetro pode ser NULL. O contexto de associação armazena em cache objetos associados durante o processo de associação, contém parâmetros que se aplicam a todas as operações usando o contexto de associação e fornece os meios pelos quais a implementação de associação deve recuperar informações sobre seu ambiente. Para obter mais informações, consulte IBindCtx.

Retornar valor

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

Código de retorno	Descrição
CACHE_E_NOCACHE_UPDATE	A operação de associação funcionou, mas nenhum cache foi atualizado.
CACHE_S_SOMECACHES_NOTUPDATED	A operação de associação funcionou, mas nem todos os caches foram atualizados.
OLE_E_CANT_BINDTOSOURCE	Não é possível associar à origem do link.

Comentários

Anotações para chamadores

Seu aplicativo de contêiner deve chamar Update se o usuário final atualizar os dados armazenados em cache para um objeto vinculado.

O usuário final pode atualizar os dados armazenados em cache para um objeto vinculado escolhendo o botão Atualizar Agora na caixa de diálogo Links . Se você usar a função OleUIEditLinks para exibir a caixa de diálogo Links , deverá implementar a interface IOleUILinkContainer . A caixa de diálogo chama suas implementações de IOleUILinkContainer::UpdateLink quando o usuário final escolhe o botão Atualizar Agora . Sua implementação desse método pode chamar Update.

Seu aplicativo de contêiner também pode chamar Update para atualizar um objeto vinculado, pois esse método chama Update quando é chamado em um objeto vinculado.

Esse método atualiza links automáticos e links manuais. Para links manuais, chamar Atualizar ou Atualizar é a única maneira de atualizar os caches. Para obter mais informações sobre links automáticos e manuais, consulte IOleLink::SetUpdateOptions.

Anotações sobre implementação

Se pbc não for NULL, a implementação do objeto vinculado de Atualizarchamará IBindCtx::RegisterObjectBound para registrar a origem do link associado. Isso garante que a origem do link permaneça em execução até que o contexto de associação seja liberado.

Os caches atuais serão deixados intactos se a origem do link não puder ser associada.

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