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

Cambia el origen de un vínculo.

Sintaxis

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

Parámetros

[in] dwLink

Identificador único definido por el contenedor para un único vínculo. Consulte IOleUILinkContainer::GetNextLink.

[in] lpszDisplayName

Puntero a la nueva cadena de origen que se va a analizar.

[in] lenFileName

Longitud de la parte del nombre de archivo inicial de la cadena lpszDisplayName . Si el origen del vínculo no se almacena en un archivo, lenFileName debe ser 0. Para vínculos OLE, llame a IOleLink::GetSourceDisplayName.

[out] pchEaten

Puntero al número de caracteres analizados correctamente en lpszDisplayName.

[in] fValidateSource

TRUE si se debe validar el moniker; Para los vínculos OLE, se debe llamar a MkParseDisplayName . FALSE si el moniker no se debe validar. Si es posible, el vínculo debe aceptar el origen no validado y marcarse como no disponible.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto	Descripción
E_ACCESSDENIED	Permisos de acceso insuficientes.
E_FAIL	Error en la operación.
E_INVALIDARG	El identificador proporcionado no es válido.
E_OUTOFMEMORY	Memoria insuficiente disponible para esta operación.

Comentarios

Notas a los autores de llamadas

Llame a este método desde el cuadro de diálogo Cambiar origen, con fValidateSource establecido inicialmente en TRUE. Se puede llamar a Change Source directamente o desde el cuadro de diálogo Vínculos. Si esta llamada a IOleUILinkContainer::SetLinkSource devuelve un error (por ejemplo, MkParseDisplayName no se pudo porque el origen no estaba disponible), debe mostrar un mensaje de origen de vínculo no válido y el usuario debe poder decidir si corregir el origen. Si el usuario decide corregir el origen, el usuario debe devolverse al cuadro de diálogo Cambiar origen con la parte no válida de la cadena de entrada resaltada. Si el usuario decide no corregir el origen, se debe llamar a IOleUILinkContainer::SetLinkSource una segunda vez con fValidateSource establecido en FALSE y el usuario debe devolverse al cuadro de diálogo Vínculos con el vínculo marcado como No disponible.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	oledlg.h

Consulte también

IOleUILinkContainer

MkParseDisplayName