Método IOleLink::Update (oleidl.h)
Novedades los datos almacenados en caché del documento compuesto para un objeto vinculado. Esto implica el enlace al origen del vínculo, si aún no está enlazado.
Sintaxis
HRESULT Update(
[in] IBindCtx *pbc
);
Parámetros
[in] pbc
Puntero a la interfaz IBindCtx en el contexto de enlace que se va a usar en el enlace del origen del vínculo. Este parámetro puede ser NULL. El contexto de enlace almacena en caché los objetos enlazados durante el proceso de enlace, contiene parámetros que se aplican a todas las operaciones mediante el contexto de enlace y proporciona los medios por los que la implementación de enlace debe recuperar información sobre su entorno. Para obtener más información, vea IBindCtx.
Valor devuelto
Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.
| Código devuelto | Descripción |
|---|---|
|
La operación de enlace funcionó pero no se actualizaron cachés. |
|
La operación de enlace funcionó, pero no todas las memorias caché se actualizaron. |
|
No se puede enlazar al origen del vínculo. |
Comentarios
Notas a los autores de llamadas
La aplicación contenedora debe llamar a Update si el usuario final actualiza los datos almacenados en caché para un objeto vinculado.El usuario final puede actualizar los datos almacenados en caché para un objeto vinculado seleccionando el botón Actualizar ahora en el cuadro de diálogo Vínculos . Si usa la función OleUIEditLinks para mostrar el cuadro de diálogo Vínculos , debe implementar la interfaz IOleUILinkContainer . El cuadro de diálogo llama a las implementaciones de IOleUILinkContainer::UpdateLink cuando el usuario final elige el botón Actualizar ahora . La implementación de ese método puede llamar a Update.
La aplicación contenedora también puede llamar a Update para actualizar un objeto vinculado, ya que ese método llama a Update cuando se llama a en un objeto vinculado.
Este método actualiza los vínculos automáticos y los vínculos manuales. En el caso de vínculos manuales, llamar a Update o Update es la única manera de actualizar las memorias caché. Para obtener más información sobre los vínculos automáticos y manuales, vea IOleLink::SetUpdateOptions.
Notas sobre la implementación
Si pbc no es NULL, la implementación del objeto vinculado de Update llama a IBindCtx::RegisterObjectBound para registrar el origen del vínculo enlazado. Esto garantiza que el origen del vínculo permanece en ejecución hasta que se libere el contexto de enlace.Las cachés actuales se dejan intactas si no se puede enlazar el origen del vínculo.
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 |