ITfKeystrokeMgr::AdviseKeyEventSink 메서드(msctf.h)

키보드 이벤트를 수신하는 키 이벤트 싱크를 설치합니다.

구문

HRESULT AdviseKeyEventSink(
  [in] TfClientId      tid,
  [in] ITfKeyEventSink *pSink,
  [in] BOOL            fForeground
);

[in] tid

키 이벤트 싱크를 소유하는 클라이언트의 식별자입니다. 이 값은 ITfThreadMgr::Activate에 대한 이전 호출을 통해 가져옵니다.

[in] pSink

ITfKeyEventSink 인터페이스에 대한 포인터입니다.

[in] fForeground

이 키 이벤트 싱크가 포그라운드 키 이벤트 싱크로 만들어지는지 지정합니다. TRUE이면 이 키 이벤트 싱크가 포그라운드 키 이벤트 싱크로 만들어집니다. 그렇지 않으면 이 키 이벤트 싱크가 포그라운드 키 이벤트 싱크가 되지 않습니다.

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
E_INVALIDARG	하나 이상의 매개 변수가 잘못되었습니다.
CONNECT_E_ADVISELIMIT	tid로 식별된 클라이언트에 키 이벤트 싱크가 설치되어 있습니다.

포그라운드 키 이벤트 싱크는 모든 키보드 이벤트를 수신합니다. 비 포그라운드 키 이벤트 싱크는 클라이언트 식별자가 소유한 것으로 표시된 텍스트에서 발생하는 유지 키 및 키 이벤트만 받습니다.


지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	msctf.h
DLL	Msctf.dll
재배포 가능 파일	Windows 2000 Professional의 TSF 1.0