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 translates, or maps, a virtual-key code into a scan code or character value, or translates a scan code into a virtual-key code.

Syntax 

UINT MapVirtualKey( 
  UINT 
uCode, 
  UINT 
uMapType 
);

Parameters

uCode

[in] Specifies the virtual-key code or scan code for a key.

uMapType

[in] Specifies the translation to perform. The value of this parameter depends on the value of the uCodeparameter

Value Description

0

uCodeis a virtual-key code and is translated into a scan code. If it is a virtual-key code that does not distinguish between left- and right-hand keys, the left-hand scan code is returned. If there is no translation, the function returns 0.

1

uCodeis a scan code and is translated into a virtual-key code that does not distinguish between left- and right-hand keys. If there is no translation, the function returns 0.

2

uCodeis a virtual-key code and is translated into an unshifted character value in the low-order word of the return value. Dead keys (diacritics) are indicated by setting the top bit of the return value. If there is no translation, the function returns 0.

3

uCodeis a scan code and is translated into a virtual-key code that distinguishes between left- and right-hand keys. If there is no translation, the function returns 0.

Return Value

A character value indicates success. Zero indicates that there is no translation.

Requirements

Header winuser.h
Library Kbdui.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also