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

Artículo
03/09/2024

Interrumpe la conexión entre un objeto vinculado y su origen de vínculo.

Sintaxis

HRESULT UnbindSource();

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente.

Comentarios

Normalmente, no se llama directamente a UnbindSource . Cuando sea necesario desactivar la conexión al origen del vínculo, el contenedor normalmente llama a IOleObject::Close o IUnknown::Release; La implementación del objeto vinculado de estos métodos llama a UnbindSource. La implementación de IAdviseSink::OnClose del objeto vinculado también llama a UnbindSource.

Notas para los implementadores

La implementación del objeto vinculado de UnbindSource no hace nada si el origen del vínculo no está enlazado actualmente. Si el origen del vínculo está enlazado, UnbindSource llama a las implementaciones de IOleObject::Unadvise e IDataObject::D Unadvise para eliminar las conexiones de asesoramiento al origen del vínculo. El método UnbindSource también llama a la implementación de IOleContainer::LockContainer del documento compuesto para desbloquear el documento compuesto contenedor. Esto deshace el bloqueo en el contenedor y las conexiones de asesoramiento que se establecieron en IOleLink::BindToSource. UnbindSource libera todos los punteros de interfaz del objeto vinculado al 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