Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/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 GetLastErrorto get an HRESULTerror code.

If the software-based input panel is unable to load the IM, the default IM is loaded in its place. Follow a call to SipSetCurrentIMwith a call to SipGetCurrentIMto 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.

SipGetCurrentIMreturns the CLSID of the active IM.

Requirements

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

See Also

Reference

SipGetCurrentIM