Método IOleUILinkContainerA::SetLinkSource (oledlg.h)

Altera a origem de um link.

Sintaxe

HRESULT SetLinkSource(
  [in]  DWORD dwLink,
  [in]  LPSTR lpszDisplayName,
  [in]  ULONG lenFileName,
  [out] ULONG *pchEaten,
  [in]  BOOL  fValidateSource
);

Parâmetros

[in] dwLink

Identificador exclusivo definido pelo contêiner para um único link. Consulte IOleUILinkContainer::GetNextLink.

[in] lpszDisplayName

Ponteiro para a nova cadeia de caracteres de origem a ser analisada.

[in] lenFileName

Comprimento da parte do nome do arquivo à esquerda da cadeia de caracteres lpszDisplayName . Se a origem do link não estiver armazenada em um arquivo, lenFileName deverá ser 0. Para links OLE, chame IOleLink::GetSourceDisplayName.

[out] pchEaten

Ponteiro para o número de caracteres analisados com êxito em lpszDisplayName.

[in] fValidateSource

TRUE se o moniker deve ser validado; para links OLE, MkParseDisplayName deve ser chamado. FALSE se o moniker não deve ser validado. Se possível, o link deve aceitar a origem não avaliada e marcar-se como indisponível.

Valor retornado

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

Código de retorno	Descrição
E_ACCESSDENIED	Permissões de acesso insuficientes.
E_FAIL	Falha na operação.
E_INVALIDARG	O identificador fornecido é inválido.
E_OUTOFMEMORY	Memória insuficiente disponível para esta operação.

Comentários

Anotações aos Chamadores

Chame esse método na caixa de diálogo Alterar Fonte , com fValidateSource inicialmente definido como TRUE. A origem da alteração pode ser chamada diretamente ou na caixa de diálogo Links . Se essa chamada para IOleUILinkContainer::SetLinkSource retornar um erro (por exemplo, MkParseDisplayName falhou porque a origem não estava disponível), você deverá exibir uma mensagem de Origem de Link Inválida e o usuário deverá ter permissão para decidir se deseja corrigir a origem. Se o usuário optar por corrigir a origem, o usuário deverá ser retornado à caixa de diálogo Alterar Fonte com a parte inválida da cadeia de caracteres de entrada realçada. Se o usuário optar por não corrigir a origem, IOleUILinkContainer::SetLinkSource deverá ser chamado uma segunda vez com fValidateSource definido como FALSE e o usuário deverá ser retornado para a caixa de diálogo Links com o link marcado como Indisponível.

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	oledlg.h

Confira também

IOleUILinkContainer

Mkparsedisplayname