Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                      ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSDEVIOCTL
 
USHORT DosDevIOCtl(0L, pbHotKey, 0x0056, 0x0004, hDevice)
PBYTE pbHotKey;    /* pointer to structure with hot key */
HFILE hDevice;     /* device handle                     */
 
The KBD_SETSESMGRHOTKEY function sets the session-manager hot keys. A new
hot key applies to all screen groups. The session manager can define up to
16 hot keys.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
pbHotKey   Points to the HOTKEY structure that contains the hot-key
           information.
 
hDevice    Identifies the keyboard that receives the device-control
           function. The handle must have been created previously by using
           the DosOpen function.
 
Return Value
 
The return value is zero if the function is successful or an error value if
an error occurs.
 
Comments
 
The KBD_SETSESMGRHOTKEY function is successful only if it is performed by
the process that initially called the KBD_SETFGNDSCREENGRP function (0x0004,
0x0055).
 
A hot key can be specified as a combination of shift flags and scan codes,
including key combinations such as ALT+ESC. The system detects the hot key
when the specified scan code is received. If a hot key has already been
defined for a given hot-key identifier, specifying the identifier again
replaces the previous definition.
 
See Also
 
DosOpen, KBD_GETSESMGRHOTKEY, KBD_SETFGNDSCREENGRP, HOTKEY
 
                                      ♦