UnloadKeyMap

4/8/2010

Unloads the keyboard mapping data specified by the parameter, and restores the default keyboard mapping data. Can be used by trusted callers only.

Syntax

HRESULT UnloadKeyMap(
    HANDLE hKeyMap
);

Parameters

  • hKeyMap
    [in] HANDLE to KeyMap identifier returned by LoadKeyMap.

Return Value

This function returns a standard HRESULT, in which a return value of S_OK indicates success. To get extended error information, call GetLastError.

Remarks

Always call UnloadKeyMapping when the device for the current mapping data is disconnected.

Regardless of whether this function is called, the default mapping data will be restored on reboot.

A complete example of how to form, load, and unload 12–key, 15–key and 30–key KEYMAPPINGS is available at <Adaptation Kit>\Public\SDK\Samples\Common\CPP\Win32\LoadKeyMap\.

Requirements

Header aygshell.h
Library aygshell.lib
Windows Mobile Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later, Windows Mobile 6 Standard and later

See Also

Reference

LoadKeyMap
Keyboard Reference

Other Resources