Partager via


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

Cette méthode retourne le profil actif actuel.

Syntaxe

HRESULT GetActiveProfile(
  [in]  REFGUID                  catid,
  [out] TF_INPUTPROCESSORPROFILE *pProfile
);

Paramètres

[in] catid

[in] ID de catégorie pour le profil. Cela doit être GUID_TFCAT_TIP_KEYBOARD. Seule GUID_TFCAT_TIP_KEYBOARD est prise en charge.

[out] pProfile

[out] Mémoire tampon pour recevoir les informations de profil.

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 est introuvable ou n’est pas actif.
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