SipSetCurrentIM (Windows Embedded CE 6.0)

1/6/2010

This function sets the class identifier (CLSID) for the current input method (IM).

Syntax

BOOL SipSetCurrentIM( 
  CLSID* pClsid
);

Parameters

  • pClsid
    [in] Pointer to the buffer that contains that contains the CLSID of the new IM.

Return Value

TRUE indicates success. FALSE indicates failure. For more specific failure information, call GetLastError to get an HRESULT error code.

If the SIP is unable to load the IM, the default IM is loaded in its place. Follow a call to SipSetCurrentIM with a call to SipGetCurrentIM to verify that the requested IM is loaded.

Remarks

An IM is a COM object; therefore, it is a window class defined by the application developer.

SipGetCurrentIM returns the CLSID of the active IM.

Requirements

Header sipapi.h
Library coredll.lib
Windows Embedded CE Windows CE 2.10 and later

See Also

Reference

SipGetCurrentIM

Other Resources

Software-based Input Panel Functions