Compartir a través de

Método ISyncMgrEvent::GetLinkReference (syncmgr.h)

  • Artículo

Obtiene la referencia del vínculo activo para el evento. El vínculo activo es una propiedad mostrada que el usuario puede hacer clic para ejecutar una acción. Esto permite al controlador mostrar una acción disponible que el usuario puede ver de un vistazo en la carpeta.

Sintaxis

HRESULT GetLinkReference(
  [out] LPWSTR *ppszLinkReference
);

Parámetros

[out] ppszLinkReference

Tipo: LPWSTR*

Cuando este método devuelve, contiene un puntero a una referencia de vínculo como una cadena Unicode.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

La referencia de vínculo se ejecuta cuando el usuario hace clic en el vínculo activo. Cuando el usuario hace clic en el vínculo, el Centro de sincronización llama a GetObject y solicita el objeto SYNCMGR_OBJECTID_EventLinkClick para la interfaz ISyncMgrEventLinkUIOperation . El objeto se inicializa con un puntero de interfaz ISyncMgrEvent que puede usar el método Run . Si el controlador no admite este identificador de objeto, el Centro de sincronización pasa la referencia de vínculo a ShellExecute.

Se espera que el evento asigne el búfer de cadena mediante CoTaskMemAlloc, que el Centro de sincronización usa para desasignar el búfer de cadenas.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado syncmgr.h