Método ITfInputProcessorProfiles::AddLanguageProfile (msctf.h)

Artículo
03/08/2023

Crea un perfil de idioma que consta de un servicio de texto específico y un identificador de idioma específico.

Sintaxis

HRESULT AddLanguageProfile(
  [in] REFCLSID    rclsid,
  [in] LANGID      langid,
  [in] REFGUID     guidProfile,
  [in] const WCHAR *pchDesc,
  [in] ULONG       cchDesc,
  [in] const WCHAR *pchIconFile,
  [in] ULONG       cchFile,
  [in] ULONG       uIconIndex
);

Parámetros

[in] rclsid

Contiene el CLSID del servicio de texto.

[in] langid

Contiene un valor LANGID que especifica el identificador de idioma del perfil al que se agrega el servicio de texto. Si contiene -1, el servicio de texto se agrega a todos los idiomas.

[in] guidProfile

Contiene un valor GUID que identifica el perfil de idioma. Este es el valor obtenido por ITfInputProcessorProfiles::GetActiveLanguageProfile cuando el perfil está activo.

[in] pchDesc

Puntero a un búfer WCHAR que contiene la cadena de descripción del servicio de texto en el perfil. Este es el nombre del servicio de texto que se muestra en la barra de idioma.

[in] cchDesc

Contiene la longitud, en caracteres, de la cadena de descripción en pchDesc. Si contiene -1, se supone que pchDesc es una cadena terminada en NULL.

[in] pchIconFile

Puntero a un búfer WCHAR que contiene la ruta de acceso y el nombre de archivo del archivo que contiene el icono que se va a mostrar en la barra de idioma del servicio de texto del perfil. Este archivo puede ser un archivo ejecutable (.exe), DLL (.dll) o un archivo de icono (.ico).

Este parámetro es opcional y puede ser NULL. En este caso, se muestra un icono predeterminado para el servicio de texto.

[in] cchFile

Contiene la longitud, en caracteres, de la cadena de archivo de icono en pchIconFile. Si contiene -1, se supone que pchIconFile es una cadena terminada en NULL. Este parámetro se omite si pchIconFile es NULL.

[in] uIconIndex

Contiene el índice de base cero del icono en pchIconFile que se mostrará en la barra de idioma del servicio de texto del perfil. Este parámetro se omite si pchIconFile es NULL.

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	pszDesc no es válido.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msctf.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional

Consulte también

ITfInputProcessorProfiles

ITfInputProcessorProfiles::GetActiveLanguageProfile

Share via