Método IOleLink::GetSourceMoniker (oleidl.h)

Artículo
08/25/2023

Recupera el moniker que identifica el origen del vínculo de un objeto vinculado.

Sintaxis

HRESULT GetSourceMoniker(
  [out] IMoniker **ppmk
);

Parámetros

[out] ppmk

Dirección de una variable de puntero IMoniker que recibe el puntero de interfaz a un moniker absoluto que identifica el origen del vínculo. Cuando se ejecuta correctamente, la implementación debe llamar a AddRef en ppmk; es responsabilidad del autor de la llamada llamar a Release. Si se produce un error, la implementación debe establecer ppmk en NULL.

Valor devuelto

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

Código devuelto	Descripción
MK_E_UNAVAILABLE	No hay ningún moniker disponible.

Comentarios

Notas a los autores de llamadas

La aplicación contenedora puede llamar a IOleLink::GetSourceMoniker para mostrar el origen actual de un vínculo en el cuadro de diálogo Vínculos . Tenga en cuenta que esto requiere que el contenedor use el método IMoniker::GetDisplayName para obtener el nombre para mostrar del moniker. Si prefiere obtener el nombre para mostrar directamente, el contenedor puede llamar a IOleLink::GetSourceDisplayName en lugar de IOleLink::GetSourceMoniker.

Si usa la función OleUIEditLinks para mostrar el cuadro de diálogo Vínculos , debe implementar la interfaz IOleUILinkContainer . El cuadro de diálogo llama a las implementaciones de IOleUILinkContainer::GetLinkSource para obtener la cadena que debe mostrar. La implementación de ese método puede llamar a IOleLink::GetSourceMoniker.

Notas para los implementadores

El objeto vinculado almacena un moniker absoluto y relativo para el origen del vínculo. Si el moniker relativo no es NULL y un moniker está disponible para el documento compuesto, IOleLink::GetSourceMoniker devuelve el moniker creado mediante la redacción del moniker relativo al final del moniker del documento compuesto. De lo contrario, devuelve el moniker absoluto o, si se produce un error, NULL.

El contenedor especifica el moniker absoluto cuando llama a una de las funciones OleCreateLink para crear un vínculo. La aplicación puede llamar a IOleLink::GetSourceMoniker o IOleLink::GetSourceDisplayName para cambiar el moniker absoluto. Además, el objeto vinculado actualiza automáticamente los monikers cada vez que se enlaza correctamente al origen del vínculo, o cuando está enlazado al origen del vínculo y recibe una notificación de cambio de nombre a través del método IAdviseSink::OnRename .

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