Compartir a través de

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

  • Artículo

Cambia el origen de un vínculo.

Sintaxis

HRESULT SetLinkSource(
  [in]  DWORD dwLink,
  [in]  LPSTR 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

   
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