Método IOleLink::GetSourceMoniker (oleidl.h)
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 |
|---|---|
|
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 |