Метод ITfInputProcessorProfileMgr::ActivateProfile (msctf.h)

Статья
03/05/2024

Метод ITfInputProcessorProfileMgr::ActivateProfile активирует профиль или раскладку клавиатуры указанной текстовой службы.

Синтаксис

HRESULT ActivateProfile(
  [in] DWORD    dwProfileType,
  [in] LANGID   langid,
  [in] REFCLSID clsid,
  [in] REFGUID  guidProfile,
  [in] HKL      hkl,
  [in] DWORD    dwFlags
);

Параметры

[in] dwProfileType

[in] Тип этого профиля. Это одно из этих значений.

Значение	Значение
TF_PROFILETYPE_INPUTPROCESSOR	Это текстовая служба.
TF_PROFILETYPE_KEYBOARDLAYOUT	Это раскладка клавиатуры.

[in] langid

[in] Идентификатор языка активируемого профиля.

[in] clsid

[in] ИДЕНТИФИКАТОР CLSID текстовой службы активируемого профиля. Это должно быть CLSID_NULL, если параметр dwProfileType является TF_PROFILETYPE_KEYBOARDLAYOUT.

[in] guidProfile

[in] GuidProfile профиля для активации. Это должно быть GUID_NULL, если параметр dwProfileType является TF_PROFILETYPE_KEYBOARDLAYOUT.

[in] hkl

[in] Дескриптор раскладки клавиатуры. Это значение должно иметь значение NULL , если параметр dwProfileType имеет TF_PROFILETYPE_INPUTPROCESSOR.

[in] dwFlags

Сочетание следующих битов:

Значение	Значение
TF_IPPMF_FORPROCESS	Активируйте этот профиль для всех потоков в процессе.
TF_IPPMF_FORSESSION	Активируйте этот профиль для всех потоков на текущем рабочем столе.
TF_IPPMF_ENABLEPROFILE	Обновите реестр, чтобы включить этот профиль для этого пользователя.
TF_IPPMF_DISABLEPROFILE
TF_IPPMF_DONTCARECURRENTINPUTLANGUAGE	Если текущий язык ввода не совпадает с языком запрошенного профиля, TSF помечает этот профиль для активации при переключении запрошенного языка ввода. Если этот флаг отключен и текущий язык ввода не совпадает, этот метод завершается ошибкой.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Значение	Описание
S_OK	Метод выполнен успешно.
S_FALSE	Языковой профиль не включен.
E_FAIL	Произошла неизвестная ошибка.
E_INVALIDARG	Один или несколько параметров являются недопустимыми.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 R2 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	msctf.h
DLL	Msctf.dll

См. также раздел

ITfInputProcessorProfileMgr

ITfInputProcessorProfileMgr::D eactivateProfile

Поделиться через