An application sends a WM_SETHOTKEY message to a window to associate a hot key with the window. When the user presses the hot key, the system activates the window.
wParam
Specifies the virtual-key code of the hot key to associate with the window. Setting this parameter to NULL removes the hot key associated with a window.
lParam
This parameter is not used.
The return value is one of the following:
| Value | Meaning |
| 2 | The function is successful but another window already has the same hot key. |
| 1 | The function is successful and no other window has the same hot key. |
| 0 | The function is unsuccessful—the window is invalid. |
| -1 | The function is unsuccessful—the hot key is invalid. |
A hot key cannot be associated with a child window.
VK_ESCAPE, VK_SPACE, and VK_TAB are invalid hot keys.
When the user presses the hot key, the system generates a WM_SYSCOMMAND message with wParam equal to SC_HOTKEY.
A window can only have one hot key. If the window already has a hot key associated with it, the new hot key replaces the old one. If more than one window has the same hot key, the window that is activated by the hot key is random.
WM_SYSCOMMAND, WM_GETHOTKEY