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

Artigo
03/01/2024

Interrompe a conexão entre um objeto vinculado e sua fonte de link.

Sintaxe

HRESULT UnbindSource();

Retornar valor

Esse método retorna S_OK em caso de êxito.

Comentários

Normalmente, você não chama UnbindSource diretamente. Quando é necessário desativar a conexão com a origem do link, seu contêiner normalmente chama IOleObject::Close ou IUnknown::Release; a implementação desses métodos do objeto vinculado chama UnbindSource. A implementação IAdviseSink::OnClose do objeto vinculado também chama UnbindSource.

Observações aos implementadores

A implementação de UnbindSource do objeto vinculado não fará nada se a origem do link não estiver vinculada no momento. Se a origem do link estiver associada, UnbindSource chamará as implementações IOleObject::Unadvise e IDataObject::D Unadvise da fonte de link para excluir as conexões de consultoria com a origem do link. O método UnbindSource também chama a implementação IOleContainer::LockContainer do documento composto para desbloquear o documento composto que contém. Isso desfaz o bloqueio no contêiner e as conexões de consultoria estabelecidas em IOleLink::BindToSource. UnbindSource libera todos os ponteiros de interface do objeto vinculado para a origem do link.

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