Compartir a través de

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

  • Artículo

El método ITfInputProcessorProfileMgr::ActivateProfile activa el perfil o el diseño del teclado del servicio de texto especificado.

Sintaxis

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

Parámetros

[in] dwProfileType

[in] Tipo de este perfil. Se trata de uno de estos valores.

Valor Significado
TF_PROFILETYPE_INPUTPROCESSOR
 Se trata de un servicio de texto.
TF_PROFILETYPE_KEYBOARDLAYOUT
 Se trata de un diseño de teclado.

[in] langid

[in] Identificador de idioma del perfil que se va a activar.

[in] clsid

[in] CLSID del servicio de texto del perfil que se va a activar. Debe ser CLSID_NULL si dwProfileType está TF_PROFILETYPE_KEYBOARDLAYOUT.

[in] guidProfile

[in] GuidProfile del perfil que se va a activar. Debe ser GUID_NULL si dwProfileType está TF_PROFILETYPE_KEYBOARDLAYOUT.

[in] hkl

[in] Identificador del diseño del teclado. Debe ser NULL si dwProfileType está TF_PROFILETYPE_INPUTPROCESSOR.

[in] dwFlags

La combinación de los bits siguientes:

Valor Significado
TF_IPPMF_FORPROCESS
 Active este perfil para todos los subprocesos del proceso.
TF_IPPMF_FORSESSION
 Active este perfil para todos los subprocesos del escritorio actual.
TF_IPPMF_ENABLEPROFILE
 Actualice el Registro para habilitar este perfil para este usuario.
TF_IPPMF_DISABLEPROFILE
TF_IPPMF_DONTCARECURRENTINPUTLANGUAGE
 Si el idioma de entrada actual no coincide con el idioma del perfil solicitado, TSF marca este perfil que se activará cuando se cambie el idioma de entrada solicitado. Si esta marca está desactivada y el idioma de entrada actual no coincide, se produce un error en este método.

Valor devuelto

Este método puede devolver uno de estos valores.

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

Requisitos

Requisito Value
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

Consulte también

ITfInputProcessorProfileMgr

ITfInputProcessorProfileMgr::D eactivateProfile