ITfKeystrokeMgr::P reserveKey 메서드(msctf.h)

아티클
08/24/2023

보존된 키를 등록합니다.

구문

HRESULT PreserveKey(
  [in] TfClientId            tid,
  [in] REFGUID               rguid,
  [in] const TF_PRESERVEDKEY *prekey,
  [in] const WCHAR           *pchDesc,
  [in] ULONG                 cchDesc
);

매개 변수

[in] tid

TSF 텍스트 서비스의 클라이언트 식별자를 포함합니다. 이 값은 ITfTextInputProcessor::Activate 메서드의 TSF 텍스트 서비스에 전달됩니다.

[in] rguid

유지된 키의 명령 GUID를 포함합니다. 이 값은 보존된 키가 활성화될 때 보존된 키를 식별하기 위해 TSF 텍스트 서비스 ITfKeyEventSink::OnPreservedKey 메서드에 전달됩니다.

[in] prekey

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

[in] pchDesc

유지된 키에 대한 설명이 포함된 유니코드 문자열에 대한 포인터입니다. cchDesc가 0이 아니면 NULL일 수 없습니다.

[in] cchDesc

pchDesc의 문자 수를 지정합니다. 설명이 필요하지 않은 경우 이 매개 변수에 대해 0을 전달합니다.

반환 값

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

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
TF_E_ALREADY_EXISTS	보존된 키가 등록됩니다.
E_INVALIDARG	하나 이상의 매개 변수가 잘못되었습니다.
E_OUTOFMEMORY	메모리 할당 오류가 발생했습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.

설명

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

요구 사항


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