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

Artículo
03/15/2023

Especifica la frecuencia con la que un objeto vinculado debe actualizar sus datos almacenados en caché.

Sintaxis

HRESULT SetUpdateOptions(
  [in] DWORD dwUpdateOpt
);

Parámetros

[in] dwUpdateOpt

Especifica la frecuencia con la que un objeto vinculado debe actualizar sus datos almacenados en caché. Los valores posibles para dwUpdateOpt se toman de la enumeración OLEUPDATE.

Valor devuelto

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

Código devuelto	Descripción
E_INVALIDARG	El valor proporcionado no es válido.

Comentarios

Notas a los autores de llamadas

La aplicación contenedora debe llamar a IOleLink::SetUpdateOptions cuando el usuario final cambie la opción de actualización de un objeto vinculado.

El usuario final selecciona la opción de actualización de un objeto vinculado mediante el cuadro de diálogo Vínculos . Si usa la función OleUIEditLinks para mostrar este cuadro de diálogo, debe implementar la interfaz IOleUILinkContainer . El cuadro de diálogo llama al método IOleUILinkContainer::SetLinkUpdateOptions para especificar la opción de actualización elegida por el usuario final. La implementación de este método debe llamar al método IOleLink::SetUpdateOptions para pasar la opción seleccionada al objeto vinculado.

Notas para los implementadores

La opción de actualización predeterminada es OLEUDPATE_ALWAYS. La implementación del objeto vinculado de IPersistStorage::Save guarda la opción de actualización actual.

Si se especifica OLEUDPATE_ALWAYS como opción de actualización, el objeto vinculado actualiza las memorias caché del vínculo en las situaciones siguientes:

Cuando se cambia la opción de actualización de manual a automática, si se ejecuta el origen del vínculo.
Cada vez que el objeto vinculado se enlaza al origen del vínculo.
Cada vez que se ejecuta el origen del vínculo y se llama a las implementaciones de IOleObject::Close, IPersistStorage::Save o IAdviseSink::OnSave del objeto vinculado.

Para los vínculos manuales y automáticos, el objeto vinculado actualiza la memoria caché cada vez que la aplicación contenedora llama a IOleObject::Update o IOleLink::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	oleidl.h