IIMECheckDefaultInputProfile Interface

Article
05/05/2014

IIMECheckDefaultInputProfile is an extended interface of Microsoft Japanese keyboard text service that provides several services for the keyboard text service.

IIMECheckDefaultInputProfile is an extended interface of Microsoft Japanese keyboard text service and provides the following services:

Checks the default keyboard text service
Provides a name for the text service
Provides an icon for the text service
Sets the default keyboard text service on the Common Text Framework

Note

If the client application does not enable Common Text Framework, a high percentage of method calls will fail.

Class ID (CLSID)

Class ID and interface IDs are defined in a header file, msimetip.h. Another way of obtaining a class ID is to get the CLSID string from HKEY_CLASSES_ROOT\IMECheckDefaultInputProfile.x.y, where x is the country name and y is the version number. For the Japanese input method, the country name is "Japan" and the version number is 1. CLSIDFromProgID Windows API helps you easily obtain a class ID. Including the initguid.h file (provided by Windows SDK) before msimetip.h defines class IDs as static data for a DLL or an executable. The initguid.h file is only included once.

Syntax

#if defined(__cplusplus) && !defined(CINTERFACE)
    
    MIDL_INTERFACE("1C4661AE-05A2-4f63-A548-7943FACCED21")
    IIMECheckDefaultInputProfile : public IUnknown
    {
    public:
        virtual HRESULT STDMETHODCALLTYPE IsTipActive( 
            /* [in] */ REFCLSID rclsid,  // Reserved
            /* [out] */ DWORD __RPC_FAR *pdwReason) = 0;
        
        virtual HRESULT STDMETHODCALLTYPE ActivateTip(DWORD dwTIPType) = 0;
        
        virtual HRESULT STDMETHODCALLTYPE GetDescription( 
            /* [in] */ LANGID langid,
            /* [out] */ WCHAR __RPC_FAR *wsz,
            /* [out] */ UINT __RPC_FAR *pcch) = 0;
        
        virtual HRESULT STDMETHODCALLTYPE GetIcon( 
            /* [in] */ BOOL fSmall,
            /* [out] */ HICON __RPC_FAR *phIcon) = 0;
        
    };
 #endif