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

Obtém a referência para o link frequente do evento. O link quente é uma propriedade exibida que o usuário pode clicar para executar uma ação. Isso permite que o manipulador mostre uma ação disponível que o usuário pode ver rapidamente na pasta.

Sintaxe

HRESULT GetLinkReference(
  [out] LPWSTR *ppszLinkReference
);

Parâmetros

[out] ppszLinkReference

Tipo: LPWSTR*

Quando esse método retorna, contém um ponteiro para uma referência de link como uma cadeia de caracteres Unicode.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A referência de link é executada quando o usuário clica no link frequente. Quando o usuário clica no link, o Sync Center chama GetObject, solicitando o objeto SYNCMGR_OBJECTID_EventLinkClick para a interface ISyncMgrEventLinkUIOperation . O objeto é inicializado com um ponteiro de interface ISyncMgrEvent que pode ser usado pelo método Run . Se o manipulador não der suporte a essa ID de objeto, o Sync Center passará a referência de link para ShellExecute.

Espera-se que o evento aloque o buffer de cadeia de caracteres usando CoTaskMemAlloc, que o Sync Center usa para desalocar o buffer de cadeia de caracteres.

Requisitos