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

Artigo
03/15/2023

Define o moniker para a origem do link.

Sintaxe

HRESULT SetSourceMoniker(
  [in] IMoniker *pmk,
  [in] REFCLSID rclsid
);

Parâmetros

[in] pmk

Um ponteiro para a interface IMoniker em um moniker que identifica a nova fonte de link do objeto vinculado. Um valor de NULL quebra o link.

[in] rclsid

O CLSID da origem do link que o objeto vinculado deve usar para acessar informações sobre o objeto vinculado quando ele não estiver associado.

Valor retornado

Esse método retorna S_OK com êxito.

Comentários

Anotações para chamadores

Seu aplicativo de contêiner pode chamar IOleLink::SetSourceMoniker quando o usuário final altera a origem de um link ou quebra um link. Observe que isso exige que o contêiner use a função MkParseDisplayName para criar um moniker com o nome de exibição inserido pelo usuário final. Se você preferir que o objeto vinculado execute a análise, seu contêiner poderá chamar IOleLink::SetSourceDisplayName em vez de IOleLink::SetSourceMoniker.

O usuário final altera a origem de um link ou quebra um link usando a caixa de diálogo Links . Se você usar a função OleUIEditLinks para exibir a caixa de diálogo Links , deverá implementar a interface IOleUILinkContainer . A caixa de diálogo chama suas implementações de IOleUILinkContainer::SetLinkSource e IOleUILinkContainer::CancelLink; sua implementação desses métodos pode chamar IOleLink::SetSourceMoniker.

Se o objeto vinculado estiver associado atualmente à fonte de link, a implementação do objeto vinculado de IOleLink::SetSourceMoniker fechará o link antes de alterar o moniker.

Anotações aos implementadores

O contrato IOleLink não especifica como o objeto vinculado armazena ou usa o moniker de origem do link. A implementação fornecida armazena o moniker absoluto especificado quando o link é criado ou quando o moniker é alterado; em seguida, ele calcula e armazena um moniker relativo. Implementações futuras podem gerenciar monikers de forma diferente para fornecer um melhor acompanhamento de moniker. O moniker absoluto fornece o caminho completo para a origem do link. O objeto vinculado usa esse moniker absoluto e o moniker do documento composto para calcular um moniker relativo que identifica a origem do link em relação ao documento composto que contém o link.

pmkCompoundDoc-RelativePathTo>(pmkAbsolute, ppmkRelative)

Ao associar à origem do link, o objeto vinculado primeiro tenta associar usando o moniker relativo. Se isso falhar, ele tentará associar o moniker absoluto.

Quando o objeto vinculado é associado com êxito usando o moniker relativo ou absoluto, ele atualiza automaticamente o outro moniker. O objeto vinculado também atualiza os dois monikers quando está associado à origem do link e recebe uma notificação de renomeação por meio do método IAdviseSink::OnRename . Um aplicativo de contêiner também pode usar o método IOleLink::SetSourceDisplayName para alterar o moniker de um link.

A implementação do objeto vinculado de IPersistStorage::Save salva o moniker relativo e absoluto.

Requisitos


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