Método IOleLink::SetSourceDisplayName (oleidl.h)
Establece el nombre para mostrar del origen del vínculo.
Sintaxis
HRESULT SetSourceDisplayName(
[in] LPCOLESTR pszStatusText
);
Parámetros
[in] pszStatusText
Puntero al nombre para mostrar del nuevo origen de vínculo. Este parámetro no puede ser NULL.
Valor devuelto
Este método devuelve S_OK cuando funciona correctamente.
Los valores de MkParseDisplayName también se pueden devolver aquí.
Comentarios
Notas a los autores de llamadas
La aplicación contenedora puede llamar a IOleLink::SetSourceDisplayName cuando el usuario final cambia el origen de un vínculo o interrumpe un vínculo. Tenga en cuenta que esto requiere que el objeto vinculado cree un moniker fuera del nombre para mostrar. Si prefiere analizar el nombre para mostrar en un moniker usted mismo, el contenedor puede llamar a IOleLink::SetSourceMoniker en lugar de IOleLink::SetSourceDisplayName.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::SetLinkSource e IOleUILinkContainer::CancelLink. La implementación de estos métodos puede llamar a IOleLink::SetSourceDisplayName.
Si la aplicación contenedora va a enlazar inmediatamente a un origen de vínculo recién especificado, debe llamar a MkParseDisplayName e IOleLink::SetSourceMoniker en su lugar y, a continuación, llamar a IOleLink::BindToSource mediante el contexto de enlace desde la operación de análisis. Al reutilizar el contexto de enlace, puede evitar la carga redundante de objetos que, de lo contrario, pueden producirse.
Notas para los implementadores
El contrato para IOleLink::SetSourceDisplayName no especifica cuándo el objeto vinculado analizará el nombre para mostrar en un moniker. El análisis puede producirse antes de que se devuelva IOleLink::SetSourceDisplayName , o el objeto vinculado puede almacenar el nombre para mostrar y analizarlo solo cuando necesite enlazar al origen del vínculo. Tenga en cuenta que el análisis del nombre para mostrar es potencialmente una operación costosa porque podría requerir el enlace al origen del vínculo. La implementación proporcionada de IOleLink::SetSourceDisplayName analiza el nombre para mostrar y, a continuación, libera el contexto de enlace usado en la operación de análisis. Esto puede dar lugar a la ejecución y, a continuación, detener el servidor de origen del vínculo.Si el objeto vinculado está enlazado al origen del vínculo actual, la implementación de IOleLink::SetSourceDisplayName interrumpe la conexión.
Para obtener más información sobre cómo almacena el objeto vinculado y usa el moniker para el origen del vínculo, vea IOleLink::SetSourceMoniker.
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 | oleidl.h |