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

Статья
08/24/2023

Метод ITfInputProcessorProfileMgr::RegisterProfile регистрирует текстовую службу и профиль.

Синтаксис

HRESULT RegisterProfile(
  [in] REFCLSID    rclsid,
  [in] LANGID      langid,
  [in] REFGUID     guidProfile,
       const WCHAR *pchDesc,
  [in] ULONG       cchDesc,
       const WCHAR *pchIconFile,
  [in] ULONG       cchFile,
  [in] ULONG       uIconIndex,
  [in] HKL         hklsubstitute,
  [in] DWORD       dwPreferredLayout,
  [in] BOOL        bEnabledByDefault,
  [in] DWORD       dwFlags
);

Параметры

[in] rclsid

[in] CLSID службы текста.

[in] langid

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

[in] guidProfile

[in] Идентификатор GUID для идентификации профиля.

pchDesc

[in, size_is(cchDesc)] Описание профиля.

[in] cchDesc

[in] Длина pchDesc.

pchIconFile

[in, size_is(cchFile] Полный путь к файлу значка.

[in] cchFile

[in] Длина файла pchIconFile.

[in] uIconIndex

[in] Индекс значка файла значка для этого профиля.

[in] hklsubstitute

[in] Замещающий hkl этого профиля.

[in] dwPreferredLayout

[in] Не используется. значение должно быть 0.

[in] bEnabledByDefault

[in] Значение true, если этот профиль включен по умолчанию.

[in] dwFlags

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

Значение	Значение
TF_RP_HIDDENINSETTINGUI	Этот профиль не будет отображаться в пользовательском интерфейсе параметра.
TF_RP_LOCALPROCESS	Этот профиль доступен только в локальном процессе.
TF_RP_LOCALTHREAD	Этот профиль доступен только в локальном потоке.

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

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

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

Требования


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

Share via