Método ITfInputProcessorProfiles::AddLanguageProfile (msctf.h)
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 |
|---|---|
|
Método realizado correctamente. |
|
Se ha producido un error no especificado. |
|
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 |