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

Fuerza los vínculos seleccionados para conectarse a su origen y recuperar la información actual.

Sintaxis

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

Parámetros

[in] dwLink

Identificador único definido por el contenedor para un único vínculo. Los contenedores pueden usar el puntero al sitio de contenedor del vínculo para este valor.

[in] fErrorMessage

Determina si el autor de la llamada (implementador de IOleUILinkContainer) debe mostrar un mensaje de error al no actualizar un vínculo. El cuadro de diálogo Actualizar vínculos establece este valor en FALSE. Los cuadros de diálogo Propiedades y vínculos del objeto lo establecen en TRUE.

[in] fReserved

Este parámetro está reservado y debe establecerse en FALSE.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto	Descripción
E_ACCESSDENIED	Permisos de acceso insuficientes.
E_FAIL	Error en la operación.
E_INVALIDARG	El identificador especificado no es válido.
E_OUTOFMEMORY	No hay memoria suficiente disponible para esta operación.

Comentarios

Notas a los autores de llamadas

Llame a este método con fErrorMessage establecido en TRUE en los casos en los que el usuario presiona expresamente un botón para actualizar un vínculo, es decir, presiona el botón Actualizar ahora de los vínculos. Llámalo con FALSE en los casos en los que el contenedor nunca debe mostrar un mensaje de error, es decir, donde se realiza un gran conjunto de operaciones y el error se debe propagar al usuario más adelante, como podría ocurrir con el medidor de progreso de vínculos de actualización. En lugar de proporcionar un mensaje para cada error, suponiendo que hay errores, proporcione un único mensaje para todos los errores al final de la operación.

Notas para los implementadores

Para los vínculos OLE, llame a IOleObject::Update.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	oledlg.h

Consulte también

IOleObject::Update

IOleUILinkContainer