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

Статья
03/05/2024

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

Синтаксис

HRESULT DeactivateProfile(
  [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_DISABLEPROFILE

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

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

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

Требования

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

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

ITfInputProcessorProfileMgr

ITfInputProcessorProfileMgr::ActivateProfile

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