ISyncMgrEvent::GetLinkReference 메서드(syncmgr.h)

이벤트에 대한 핫 링크에 대한 참조를 가져옵니다. 핫 링크는 사용자가 클릭하여 작업을 실행할 수 있는 표시된 속성입니다. 이를 통해 처리기는 사용자가 폴더에서 한눈에 볼 수 있는 사용 가능한 작업을 표시할 수 있습니다.

구문

HRESULT GetLinkReference(
  [out] LPWSTR *ppszLinkReference
);

매개 변수

[out] ppszLinkReference

형식: LPWSTR*

이 메서드가 반환되면 링크 참조에 대한 포인터를 유니코드 문자열로 포함합니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

링크 참조는 사용자가 핫 링크를 클릭할 때 실행됩니다. 사용자가 링크를 클릭하면 동기화 센터에서 GetObject를 호출하여 ISyncMgrEventLinkUIOperation 인터페이스에 대한 SYNCMGR_OBJECTID_EventLinkClick 개체를 요청합니다. 개체는 Run 메서드에서 사용할 수 있는 ISyncMgrEvent 인터페이스 포인터를 사용하여 초기화됩니다. 처리기가 이 개체 ID를 지원하지 않는 경우 동기화 센터는 ShellExecute에 링크 참조를 전달합니다.

이 이벤트는 동기화 센터에서 문자열 버퍼의 할당을 취소하는 데 사용하는 CoTaskMemAlloc을 사용하여 문자열 버퍼를 할당해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	syncmgr.h