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

Artigo
08/25/2023

Recupera o moniker que identifica a origem do link de um objeto vinculado.

Sintaxe

HRESULT GetSourceMoniker(
  [out] IMoniker **ppmk
);

Parâmetros

[out] ppmk

Endereço de uma variável de ponteiro IMoniker que recebe o ponteiro de interface para um moniker absoluto que identifica a origem do link. Quando bem-sucedida, a implementação deve chamar AddRef em ppmk; é responsabilidade do chamador chamar Release. Se ocorrer um erro, a implementação deverá definir ppmk como NULL.

Valor retornado

Esse método retorna S_OK com êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno	Descrição
MK_E_UNAVAILABLE	Nenhum moniker está disponível.

Comentários

Anotações para chamadores

Seu aplicativo de contêiner pode chamar IOleLink::GetSourceMoniker para exibir a origem atual de um link na caixa de diálogo Links . Observe que isso exige que o contêiner use o método IMoniker::GetDisplayName para obter o nome de exibição do moniker. Se você preferir obter o nome de exibição diretamente, seu contêiner poderá chamar IOleLink::GetSourceDisplayName em vez de IOleLink::GetSourceMoniker.

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::GetLinkSource para obter a cadeia de caracteres que deve ser exibida. Sua implementação desse método pode chamar IOleLink::GetSourceMoniker.

Anotações aos implementadores

O objeto vinculado armazena um moniker absoluto e relativo para a origem do link. Se o moniker relativo não for NULL e um moniker estiver disponível para o documento composto, IOleLink::GetSourceMoniker retornará o moniker criado compondo o moniker relativo no final do moniker do documento composto. Caso contrário, ele retornará o moniker absoluto ou, se ocorrer um erro, NULL.

O contêiner especifica o moniker absoluto quando chama uma das funções OleCreateLink para criar um link. O aplicativo pode chamar IOleLink::GetSourceMoniker ou IOleLink::GetSourceDisplayName para alterar o moniker absoluto. Além disso, o objeto vinculado atualiza automaticamente os monikers sempre que ele se associa com êxito à origem do link ou quando está associado à origem do link e recebe uma notificação de renomeação por meio do método IAdviseSink::OnRename .

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