다음을 통해 공유


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

유지된 키에 대한 명령 GUID를 가져옵니다.

구문

HRESULT GetPreservedKey(
  [in]  ITfContext            *pic,
  [in]  const TF_PRESERVEDKEY *pprekey,
  [out] GUID                  *pguid
);

매개 변수

[in] pic

애플리케이션 컨텍스트에 대한 포인터입니다. 이 값은 ITfDocumentMgr::CreateContext에 대한 이전 호출에서 반환됩니다.

[in] pprekey

가져올 보존된 키를 식별하는 TF_PRESERVEDKEY 구조체에 대한 포인터입니다. uVKey 멤버는 가상 키 코드를 포함하고 uModifiers 멤버는 유지된 키의 한정자를 식별합니다. uVKey 멤버는 256보다 작아야 합니다.

[out] pguid

유지된 키의 명령 GUID를 수신하는 GUID 값에 대한 포인터입니다. ITfKeystrokeMgr::P reserveKey에 대한 TSF 텍스트 서비스 호출에 전달된 GUID입니다. 보존된 키를 찾을 수 없는 경우 이 값은 GUID_NULL 받습니다.

반환 값

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

Description
S_OK
메서드가 성공했고 유지된 키가 발견되었습니다.
S_FALSE
메서드가 성공했지만 유지된 키를 찾을 수 없습니다. pguid 는 GUID_NULL 받습니다.
E_INVALIDARG
하나 이상의 매개 변수가 잘못되었습니다.
E_FAIL
지정되지 않은 오류가 발생했습니다.

설명

유지 키는 TSF 텍스트 서비스에 의해 등록되며 TSF 텍스트 서비스에서 구현하는 일반적인 명령에 대한 바로 가기 키를 제공하는 데 사용됩니다.

요구 사항

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

참고 항목

ITfDocumentMgr::CreateContext

ITfKeystrokeMgr

ITfKeystrokeMgr::P reserveKey

TF_PRESERVEDKEY