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

Artículo
08/25/2023

Recupera información sobre un vínculo que se puede mostrar en el cuadro de diálogo Vínculos .

Sintaxis

HRESULT GetLinkSource(
  [in]            DWORD  dwLink,
  [out, optional] LPWSTR *lplpszDisplayName,
  [out]           ULONG  *lplenFileName,
  [out, optional] LPWSTR *lplpszFullLinkType,
  [out, optional] LPWSTR *lplpszShortLinkType,
  [out]           BOOL   *lpfSourceAvailable,
  [out]           BOOL   *lpfIsSelected
);

Parámetros

[in] dwLink

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

[out, optional] lplpszDisplayName

Dirección de una variable de puntero que recibe un puntero a la cadena de nombre para mostrar completa del origen del vínculo. El cuadro de diálogo Vínculos liberará esta cadena.

[out] lplenFileName

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

[out, optional] lplpszFullLinkType

Dirección de una variable de puntero que recibe un puntero a la cadena de tipo de vínculo completa que se muestra en la parte inferior del cuadro de diálogo Vínculos . El autor de la llamada asigna esta cadena. El cuadro de diálogo Vínculos liberará esta cadena. Para los vínculos OLE, debe ser el nombre completo del tipo de usuario. Use IOleObject::GetUserType y especifique USERCLASSTYPE_FULL para dwFormOfType.

[out, optional] lplpszShortLinkType

Dirección de una variable de puntero que recibe un puntero a la cadena de tipo de vínculo corto que se muestra en el cuadro de lista del cuadro de diálogo Vínculos . El autor de la llamada asigna esta cadena. El cuadro de diálogo Vínculos liberará esta cadena. Para los vínculos OLE, debe ser el nombre de tipo de usuario corto. Use IOleObject::GetUserType y especifique USERCLASSTYPE_SHORT para dwFormOfType.

[out] lpfSourceAvailable

Puntero que devuelve FALSE si se sabe que un vínculo no está disponible, ya que el vínculo es para algún documento conocido pero no disponible. Algunas opciones, como Actualizar ahora, están deshabilitadas (atenuadas en la interfaz de usuario) para estos casos.

[out] lpfIsSelected

Puntero a una variable que indica al cuadro de diálogo Editar vínculos que la entrada de este vínculo debe seleccionarse en el cuadro de lista de selección múltiple del cuadro de diálogo. OleUIEditLinks llama a este método al menos una vez para cada elemento que se va a colocar en la lista de vínculos. Si ninguno de ellos devuelve TRUE, ninguno de ellos se seleccionará cuando se muestre por primera vez el cuadro de diálogo. Si todos ellos devuelven TRUE, se mostrarán todos. Es decir, devuelve TRUE si este vínculo forma parte actualmente de la selección en el documento subyacente, FALSE si no es así. Los vínculos seleccionados en el documento subyacente se seleccionan en el cuadro de diálogo; De este modo, el usuario puede seleccionar un conjunto de vínculos y usar el cuadro de diálogo para actualizarlos o cambiar sus orígenes simultáneamente.

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 especificado no es válido.
E_OUTOFMEMORY	No hay memoria suficiente disponible para esta operación.

Comentarios

Notas a los autores de llamadas

Llame a este método durante la inicialización del cuadro de diálogo, después de volver desde el cuadro de diálogo Cambiar origen.

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