Método IOleLink::SetSourceDisplayName (oleidl.h)
Define o nome de exibição da origem do link.
Sintaxe
HRESULT SetSourceDisplayName(
[in] LPCOLESTR pszStatusText
);
Parâmetros
[in] pszStatusText
Um ponteiro para o nome de exibição da nova fonte de link. Esse parâmetro não pode ser NULL.
Retornar valor
Esse método retorna S_OK em caso de êxito.
Os valores de MkParseDisplayName também podem ser retornados aqui.
Comentários
Anotações aos Chamadores
Seu aplicativo de contêiner pode chamar IOleLink::SetSourceDisplayName quando o usuário final altera a origem de um link ou interrompe um link. Observe que isso requer que o objeto vinculado crie um moniker com o nome de exibição. Se você preferir analisar o nome de exibição em um moniker por conta própria, seu contêiner poderá chamar IOleLink::SetSourceMoniker em vez de IOleLink::SetSourceDisplayName.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::SetSourceDisplayName.
Se o aplicativo de contêiner for imediatamente associado a uma fonte de link recém-especificada, você deverá chamar MkParseDisplayName e IOleLink::SetSourceMoniker e, em seguida, chamar IOleLink::BindToSource usando o contexto de associação da operação de análise. Reutilizando o contexto de associação, você pode evitar o carregamento redundante de objetos que, de outra forma, poderiam ocorrer.
Observações aos implementadores
O contrato para IOleLink::SetSourceDisplayName não especifica quando o objeto vinculado analisará o nome de exibição em um moniker. A análise pode ocorrer antes que IOleLink::SetSourceDisplayName retorne ou o objeto vinculado pode armazenar o nome de exibição e analisá-lo somente quando precisar se associar à origem do link. Observe que analisar o nome de exibição é potencialmente uma operação cara porque pode exigir associação à origem do link. A implementação fornecida de IOleLink::SetSourceDisplayName analisa o nome de exibição e libera o contexto de associação usado na operação de análise. Isso pode resultar na execução e, em seguida, na interrupção do servidor de origem do link.Se o objeto vinculado estiver associado à origem do link atual, a implementação de IOleLink::SetSourceDisplayName interromperá a conexão.
Para obter mais informações sobre como o objeto vinculado armazena e usa o moniker para a origem do link, consulte IOleLink::SetSourceMoniker.
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 |