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

Artigo
03/01/2024

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