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 displays the configuration dialog box for the IME.

Syntax 

BOOL ImmConfigureIME( 
  HKL
 hKL, 
  HWND
 hWnd, 
  DWORD
 dwMode, 
  LPVOID 
lpData
);

Parameters

hKL

[in] Handle to the keyboard layout.

hWnd

[in] Handle to the parent window for the dialog box.

dwMode

[in] Value that specifies the type of dialog box to display. The following table shows the values this parameter can take.

Value Description

IME_CONFIG_GENERAL

Displays general-purpose configuration dialog box.

IME_CONFIG_REGISTERWORD

Displays register word dialog box.

IME_CONFIG_SELECTDICTIONARY

Displays dictionary selection dialog box.
lpData

[in] Long pointer to supplemental data. If dwModeis IME_CONFIG_REGISTERWORD, this parameter must be the address of a REGISTERWORDstructure.

If dwModeis not IME_CONFIG_REGISTERWORD, this parameter is ignored.

Return Value

Nonzero indicates success. Zero indicates failure.

Remarks

Control Panel calls the ImmConfigureIMEfunction.

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

See Also

Reference

REGISTERWORD