ImmGetHotKey

This function retrieves the value of the input method editor (IME) hot key.

BOOL WINAPI ImmGetHotKey( 
DWORD dwHotKeyID,
LPUINT lpuModifiers, 
LPUINT lpuVKey, 
LPHKL lphKL);

Parameters

  • dwHotKeyID
    [in] Specifies the hot key identifier.

  • lpuModifiers
    [out] Long pointer to the combination keys used with the hot key. Keys include MOD_ALT, MOD_CONTROL, MOD_SHIFT, MOD_LEFT, and MOD_RIGHT. The key up flag, MOD_ON_KEYUP, indicates the hot key is effective when the key is up. The modifier ignore flag, MOD_IGNORE_ALL_MODIFIER, indicates the combination of modifiers are ignored in hot key matching.

  • lpuVKey
    [out] Long pointer to the virtual key code of the hot key.

  • lphKL
    [out] Long pointer to the handle to the keyboard layout of the IME. If the return value of this parameter is NULL, the hot key can switch to the IME with this keyboard layout handle.

    Windows CE does not support true keyboard layouts. In this instance, however, Windows CE returns the keyboard handle that is associated with the current IME and locale.

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

This function is called by the IME control panel application.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.10 and later Imm.h   Coreimm.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.