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

Artículo
08/24/2023

El método ITfInputProcessorProfileMgr::RegisterProfile registra el servicio de texto y el perfil.

Sintaxis

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

Parámetros

[in] rclsid

[in] CLSID del servicio de texto.

[in] langid

[in] Identificador de idioma del perfil.

[in] guidProfile

[in] GUID para identificar el perfil.

pchDesc

[in, size_is(cchDesc)] Descripción del perfil.

[in] cchDesc

[in] Longitud de pchDesc.

pchIconFile

[in, size_is(cchFile] Ruta de acceso completa del archivo de icono.

[in] cchFile

[in] Longitud de pchIconFile.

[in] uIconIndex

[in] Índice de icono del archivo de icono de este perfil.

[in] hklsubstitute

[in] El hkl sustituto de este perfil.

[in] dwPreferredLayout

[in] Sin utilizar. debe ser 0.

[in] bEnabledByDefault

[in] True si este perfil está habilitado de forma predeterminada.

[in] dwFlags

[in] Combinación de los bits siguientes:

Valor	Significado
TF_RP_HIDDENINSETTINGUI	Este perfil no aparecerá en la interfaz de usuario de configuración.
TF_RP_LOCALPROCESS	Este perfil solo está disponible en el proceso local.
TF_RP_LOCALTHREAD	Este perfil solo está disponible en el subproceso local.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
E_FAIL	Se ha producido un error no especificado.
E_INVALIDARG	Uno o varios parámetros no son válidos.

Requisitos


Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 R2 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msctf.h
Archivo DLL	Msctf.dll