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 method enables an input method (IM) to send information to an input method editor (IME).

Syntax

HRESULT SendAlternatives2(
  LMDATA* 
plmd
);

Parameters

plmd

A pointer to a LMDATAstructure that contains information that is to be sent from the IM to the IME.

Return Value

An appropriate HRESULTvalue is returned.

Remarks

An alternatives list is a list of choices provided to the IME for integration into the candidate list. This candidate list then can be presented to the end-user to enable the end-user to make the best choice.

When the alternatives are sent to the software-based input panel, they are packaged up and the software-based input panel sends the structure in a WM_SYSCOPYDATAmessage to the active control with the wParamset to WMSCD_CHAR_RANKED_ALTS. If the active control does not handle the message, the message is forwarded to the IME for processing.

If an application or input method editor (IME) returns TRUE in response to a WM_SYSCOPYDATAmessage, this method resends the first candidate character.

Requirements

Header sip.h
Library uuid.lib
Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IIMCallback2

Other Resources