ITfInputProcessorProfiles::AddLanguageProfile method (msctf.h)
Creates a language profile that consists of a specific text service and a specific language identifier.
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 );
Contains the text service CLSID.
Contains a LANGID value that specifies the language identifier of the profile that the text service is added to. If this contains -1, the text service is added to all languages.
Contains a GUID value that identifies the language profile. This is the value obtained by ITfInputProcessorProfiles::GetActiveLanguageProfile when the profile is active.
Pointer to a WCHAR buffer that contains the description string for the text service in the profile. This is the text service name displayed in the language bar.
Contains the length, in characters, of the description string in pchDesc. If this contains -1, pchDesc is assumed to be a NULL-terminated string.
Pointer to a WCHAR buffer that contains the path and file name of the file that contains the icon to be displayed in the language bar for the text service in the profile. This file can be an executable (.exe), DLL (.dll) or icon (.ico) file.
This parameter is optional and can be NULL. In this case, a default icon is displayed for the text service.
Contains the length, in characters, of the icon file string in pchIconFile. If this contains -1, pchIconFile is assumed to be a NULL-terminated string. This parameter is ignored if pchIconFile is NULL.
Contains the zero-based index of the icon in pchIconFile to be displayed in the language bar for the text service in the profile. This parameter is ignored if pchIconFile is NULL.
This method can return one of these values.
||The method was successful.|
||An unspecified error occurred.|
||pszDesc is invalid.|
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|
|Redistributable||TSF 1.0 on Windows 2000 Professional|