OemKeyScan function (winuser.h)
Maps OEMASCII codes 0 through 0x0FF into the OEM scan codes and shift states. The function provides information that allows a program to send OEM text to another program by simulating keyboard input.
Syntax
DWORD OemKeyScan(
[in] WORD wOemChar
);
Parameters
[in] wOemChar
Type: WORD
The ASCII value of the OEM character.
Return value
Type: DWORD
The low-order word of the return value contains the scan code of the OEM character, and the high-order word contains the shift state, which can be a combination of the following bits.
| Bit | Description |
|---|---|
|
Either SHIFT key is pressed. |
|
Either CTRL key is pressed. |
|
Either ALT key is pressed. |
|
The Hankaku key is pressed. |
|
Reserved (defined by the keyboard layout driver). |
|
Reserved (defined by the keyboard layout driver). |
If the character cannot be produced by a single keystroke using the current keyboard layout, the return value is –1.
Remarks
This function does not provide translations for characters that require CTRL+ALT or dead keys. Characters not translated by this function must be copied by simulating input using the ALT+ keypad mechanism. The NUMLOCK key must be off.
This function does not provide translations for characters that cannot be typed with one keystroke using the current keyboard layout, such as characters with diacritics requiring dead keys. Characters not translated by this function may be simulated using the ALT+ keypad mechanism. The NUMLOCK key must be on.
This function is implemented using the VkKeyScan function.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | winuser.h (include Windows.h) |
| Library | User32.lib |
| DLL | User32.dll |
See also
Conceptual
Reference