subcalls.hlp (Topic list)
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.
VioScrUnLock (1.2)
Overview                                            Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_VIO
 
USHORT VioScrUnLock(hvio)
HVIO hvio;    /* video handle */
 
The VioScrUnLock function unlocks the screen previously locked by the
process.
 
The VioScrUnLock function is a family API function.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hvio       Identifies an advanced video-input-and-output (AVIO) presentation
           space. For AVIO programs, this handle must have been created
           previously using the VioCreatePS function. For other programs,
           hvio must be NULL.
 
Return Value
 
The return value is zero if the function is successful. Otherwise, it is an
error value, which may be one of the following:
 
     ERROR_VIO_INVALID_HANDLE
     ERROR_VIO_UNLOCK
 
Example
 
This example calls the VioScrLock function to lock the screen, then calls
VioScrUnLock to unlock the screen:
 
USHORT fNotLocked;
VioScrLock(LOCKIO_WAIT, &fNotLocked, 0);
    .
    .
    .
VioScrUnLock(0);
 
See Also
 
VioCreatePS, VioScrLock