Método IOleLink::Update (oleidl.h)
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 |
|---|---|
|
A operação de associação funcionou, mas nenhum cache foi atualizado. |
|
A operação de associação funcionou, mas nem todos os caches foram atualizados. |
|
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 |