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

Article
02/29/2024

La méthode ITfInputProcessorProfileMgr ::ActivateProfile active le profil ou la disposition du clavier du service de texte spécifié.

Syntaxe

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

Paramètres

[in] dwProfileType

[in] Type de ce profil. Il s’agit de l’une de ces valeurs.

Valeur	Signification
TF_PROFILETYPE_INPUTPROCESSOR	Il s’agit d’un service de texte.
TF_PROFILETYPE_KEYBOARDLAYOUT	Il s’agit d’une disposition de clavier.

[in] langid

[in] ID de langue du profil à activer.

[in] clsid

[in] CLSID du service de texte du profil à activer. Cela doit être CLSID_NULL si dwProfileType est TF_PROFILETYPE_KEYBOARDLAYOUT.

[in] guidProfile

[in] GuidProfile du profil à activer. Cela doit être GUID_NULL si dwProfileType est TF_PROFILETYPE_KEYBOARDLAYOUT.

[in] hkl

[in] Poignée de la disposition du clavier. Cette valeur doit être NULL si dwProfileType est TF_PROFILETYPE_INPUTPROCESSOR.

[in] dwFlags

Combinaison des bits suivants :

Valeur	Signification
TF_IPPMF_FORPROCESS	Activez ce profil pour tous les threads du processus.
TF_IPPMF_FORSESSION	Activez ce profil pour tous les threads du bureau actuel.
TF_IPPMF_ENABLEPROFILE	Mettez à jour le Registre pour activer ce profil pour cet utilisateur.
TF_IPPMF_DISABLEPROFILE
TF_IPPMF_DONTCARECURRENTINPUTLANGUAGE	Si la langue d’entrée actuelle ne correspond pas à la langue du profil demandé, TSF marque l’activation de ce profil lorsque la langue d’entrée demandée est commutée. Si cet indicateur est désactivé et que la langue d’entrée actuelle n’est pas mise en correspondance, cette méthode échoue.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Description
S_OK	La méthode a réussi.
S_FALSE	Le profil de langue n’est pas activé.
E_FAIL	Une erreur non spécifiée s'est produite.
E_INVALIDARG	Un ou plusieurs paramètres ne sont pas valides.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	msctf.h
DLL	Msctf.dll

Voir aussi

ITfInputProcessorProfileMgr

ITfInputProcessorProfileMgr ::D eactivateProfile

Partager via