Global Interfaces

  • Article

 

August 2003

Microsoft Corporation

This document describes the characteristics of global interfaces for Microsoft® IME 2003. (2 printed pages)

The characteristics of global interfaces are as follows:

  • Can be activated whenever an application wishes to use the interface. This means that IME can be inactive.
  • Does not have IME context information.
  • Must be in the COM format, where an interface is defined by class ID and interface ID.
  • Each language will have a unique class ID. For example, Japanese Microsoft IME will have a class ID named CLSID_MSIME_JAPANESE.

Each new version of an interface must use a new interface ID. Please refer to the COM specification when implementing or using the COM interface.

The following interfaces are currently provided in this format:

IIMEActiveDict
IFECommon
IFELanguage
IFEDictionary
CIMEShare
IImePad, IImePadApplet
IIMECheckDefaultInputProfile
IIMEFNIMEPad

Class ID

Class ID and interface IDs for the MS-IME are defined in a header file, msime.h. Another way of obtaining class ID is to get the CLSID string from HKEY_CLASSES_ROOT\MSIME.x.y, where "x" is the country name and "y" is the version number. For Microsoft IME 2003 (Japanese), the country name is "Japan" and the version number is 10. Including the INITGUID.H file (provided by Windows SDK) before "MSIME.H" defines class IDs as static data for a DLL or an executable. The INITGUID.H file is only included once.