ITfKeystrokeMgr::P reserveKey 메서드(msctf.h)
보존된 키를 등록합니다.
구문
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 |
|---|---|
|
메서드를 성공적으로 수행했습니다. |
|
보존된 키가 등록됩니다. |
|
하나 이상의 매개 변수가 잘못되었습니다. |
|
메모리 할당 오류가 발생했습니다. |
|
지정되지 않은 오류가 발생했습니다. |
설명
유지 키는 TSF 텍스트 서비스에 의해 등록되며 TSF 텍스트 서비스에서 구현하는 일반적인 명령에 대한 바로 가기 키를 제공합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | msctf.h |
| DLL | Msctf.dll |
| 재배포 가능 파일 | Windows 2000 Professional의 TSF 1.0 |
참고 항목
ITfKeyEventSink::OnPreservedKey
ITfKeystrokeMgr::UnpreserveKey