Método IOleUILinkContainerA::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] LPSTR *lplpszDisplayName,
  [out]           ULONG *lplenFileName,
  [out, optional] LPSTR *lplpszFullLinkType,
  [out, optional] LPSTR *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 inicial del nombre de archivo de la cadena lplpszDisplayName . Si el origen del vínculo no se almacena en un archivo, lplenFileName debe ser 0. Para 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 completo 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 de tipo de usuario completo. 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, no se seleccionará ninguno cuando se muestre el cuadro de diálogo por primera vez. 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 suficiente memoria 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

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