Método IOleUILinkContainerA::UpdateLink (oledlg.h)

Força os links selecionados a se conectarem à origem e recuperarem as informações atuais.

Sintaxe

HRESULT UpdateLink(
  [in] DWORD dwLink,
  [in] BOOL  fErrorMessage,
  [in] BOOL  fReserved
);

Parâmetros

[in] dwLink

Identificador exclusivo definido pelo contêiner para um único link. Os contêineres podem usar o ponteiro para o site de contêiner do link para esse valor.

[in] fErrorMessage

Determina se o chamador (implementador de IOleUILinkContainer) deve mostrar uma mensagem de erro após a falha ao atualizar um link. A caixa de diálogo Atualizar Links define isso como FALSE. As caixas de diálogo Propriedades do Objeto e Links o definem como TRUE.

[in] fReserved

Esse parâmetro é reservado e deve ser definido como FALSE.

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_ACCESSDENIED	Permissões de acesso insuficientes.
E_FAIL	Falha na operação.
E_INVALIDARG	O identificador especificado é inválido.
E_OUTOFMEMORY	Não há memória suficiente disponível para esta operação.

Comentários

Anotações aos Chamadores

Chame esse método com fErrorMessage definido como TRUE nos casos em que o usuário pressiona expressamente um botão para ter um link atualizado, ou seja, pressiona o botão Atualizar Agora dos links. Chame-o com FALSE nos casos em que o contêiner nunca deve exibir uma mensagem de erro, ou seja, em que um grande conjunto de operações está sendo executado e o erro deve ser propagado de volta para o usuário posteriormente, como pode ocorrer com o medidor de progresso dos links de atualização . Em vez de fornecer uma mensagem para cada falha, supondo que haja falhas, forneça uma única mensagem para todas as falhas no final da operação.

Observações aos implementadores

Para links OLE, chame IOleObject::Update.

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	oledlg.h

Confira também

IOleObject::Update

IOleUILinkContainer