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

La méthode ITfInputProcessorProfileMgr::RegisterProfile inscrit le service de texte et le profil.

Syntaxe

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
);

Paramètres

[in] rclsid

[in] CLSID du service de texte.

[in] langid

[in] ID de langue du profil.

[in] guidProfile

[in] GUID permettant d’identifier le profil.

pchDesc

[in, size_is(cchDesc)] Description du profil.

[in] cchDesc

[in] Longueur de pchDesc.

pchIconFile

[in, size_is(cchFile] Chemin d’accès complet du fichier d’icônes.

[in] cchFile

[in] Longueur de pchIconFile.

[in] uIconIndex

[in] Index d’icône du fichier d’icônes pour ce profil.

[in] hklsubstitute

[in] Remplacement hkl de ce profil.

[in] dwPreferredLayout

[in] Inutilisé. cela doit être 0.

[in] bEnabledByDefault

[in] True si ce profil est activé par défaut.

[in] dwFlags

[in] Combinaison des bits suivants :

Valeur Signification
TF_RP_HIDDENINSETTINGUI
Ce profil n’apparaîtra pas dans l’interface utilisateur des paramètres.
TF_RP_LOCALPROCESS
Ce profil est disponible uniquement sur le processus local.
TF_RP_LOCALTHREAD
Ce profil est disponible uniquement sur le thread local.

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.

Spécifications

   
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