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 enables an input method editor (IME) to create a new input method context (IMC) component that is a member of an IMC.

Syntax

HIMCC WINAPI ImmCreateIMCC( 
  DWORD 
dwSize
);

Parameters

dwSize

[in] Size of the new IMC component.

Return Value

The IMC component handle indicates success. Zero indicates failure.

Remarks

The IMC component created by this function is initialized with zero.

An IME monitors the user's keystrokes, anticipates the characters the user may want, and presents a list of candidate characters from which to choose.

An IMC is a structure, maintained by the IME and used by IME windows, that contains information about the status of the IME. By default, the system creates and assigns an IMC to a thread if it calls a function that requires the use of an IMC. Within the thread, this default input context is a shared resource and is associated with each newly created window. An IMC requires considerable system resources, so use them judiciously.

Requirements

Header imm.h
Library Coreimm.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later