Partager via

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

  • Article

La méthode ITfInputProcessorProfileMgr ::GetProfile retourne les informations du profil ou de la disposition du clavier du service de texte spécifié dans TF_INPUTPROCESSORPROFILE structure.

Syntaxe

HRESULT GetProfile(
  [in]  DWORD                    dwProfileType,
  [in]  LANGID                   langid,
  [in]  REFCLSID                 clsid,
  [in]  REFGUID                  guidProfile,
  [in]  HKL                      hkl,
  [out] TF_INPUTPROCESSORPROFILE *pProfile
);

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.

[out] pProfile

[out] Mémoire tampon à recevoir TF_INPUTPROCESSORPROFILE.

Valeur retournée

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

Valeur Description
S_OK
 La méthode a réussi.
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