ISyncMgrEvent：：GetLinkReference 方法 (syncmgr.h)

取得事件作用中鏈接的參考。 作用中連結是使用者可以按下以執行動作的顯示屬性。 這可讓處理程序顯示使用者一目了然的可用動作。

語法

HRESULT GetLinkReference(
  [out] LPWSTR *ppszLinkReference
);

參數

[out] ppszLinkReference

類型： LPWSTR*

當這個方法傳回時，會包含鏈接參考的指標做為 Unicode 字串。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

當使用者按下熱連結時，就會執行連結參考。 當使用者按兩下連結時，同步中心會呼叫 GetObject，要求 ISyncMgrEventLinkUIOperation 介面的SYNCMGR_OBJECTID_EventLinkClick物件。 物件會使用 Run 方法可使用的 ISyncMgrEvent 介面指標初始化。 如果處理程式不支援此物件標識符，同步中心會將連結參考傳遞至 ShellExecute。

事件預期會使用 CoTaskMemAlloc 來配置字串緩衝區，同步中心會使用此 CoTaskMemAlloc 來解除分配字串緩衝區。

規格需求