Método ITfInputProcessorProfileMgr::ActivateProfile (msctf.h)

Artigo
02/29/2024

O método ITfInputProcessorProfileMgr::ActivateProfile ativa o perfil ou o layout de teclado do serviço de texto especificado.

Sintaxe

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

Parâmetros

[in] dwProfileType

[in] O tipo desse perfil. Esse é um desses valores.

Valor	Significado
TF_PROFILETYPE_INPUTPROCESSOR	Esse é um serviço de texto.
TF_PROFILETYPE_KEYBOARDLAYOUT	Este é um layout de teclado.

[in] langid

[in] A ID do idioma do perfil a ser ativado.

[in] clsid

[in] O CLSID do serviço de texto do perfil a ser ativado. Isso deve ser CLSID_NULL se dwProfileType for TF_PROFILETYPE_KEYBOARDLAYOUT.

[in] guidProfile

[in] O guidProfile do perfil a ser ativado. Isso deve ser GUID_NULL se dwProfileType for TF_PROFILETYPE_KEYBOARDLAYOUT.

[in] hkl

[in] O identificador do layout do teclado. Isso deve ser NULL se dwProfileType for TF_PROFILETYPE_INPUTPROCESSOR.

[in] dwFlags

A combinação dos seguintes bits:

Valor	Significado
TF_IPPMF_FORPROCESS	Ative esse perfil para todos os threads no processo.
TF_IPPMF_FORSESSION	Ative esse perfil para todos os threads na área de trabalho atual.
TF_IPPMF_ENABLEPROFILE	Atualize o registro para habilitar esse perfil para esse usuário.
TF_IPPMF_DISABLEPROFILE
TF_IPPMF_DONTCARECURRENTINPUTLANGUAGE	Se o idioma de entrada atual não corresponder ao idioma do perfil solicitado, o TSF marcará esse perfil para ser ativado quando o idioma de entrada solicitado for alternado. Se esse sinalizador estiver desativado e o idioma de entrada atual não for correspondido, esse método falhará.

Retornar valor

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	O perfil de idioma não está habilitado.
E_FAIL	Ocorreu um erro não especificado.
E_INVALIDARG	Um ou mais parâmetros são inválidos.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 R2 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	msctf.h
DLL	Msctf.dll

Confira também

ITfInputProcessorProfileMgr

ITfInputProcessorProfileMgr::D eactivateProfile

Compartilhar via