VioSavRedrawUndo

Description

Allows one thread within a process to cancel a VioSavRedrawWait issued by another thread within the same process.

Syntax

#define INCL_VIO
#include <os2.h>

ULONG     OwnerIndic;  /*  Ownership indicator */
ULONG     KillIndic;   /*  Terminate indicator */
HVIO      VioHandle;   /*  Reserved.  Must be 0. */
APIRET    rc;          /*  Return code. */

rc = VioSavRedrawUndo(OwnerIndic, KillIndic,
       VioHandle);

Parameters

OwnerIndic (ULONG) - input

Ownership indicator

Indicates whether the thread issuing VioSavRedrawUndo wants ownership of VioSavRedrawUndo to be reserved for its process.

 Value            Definition 
  0      Reserve ownership. 
  1      Give up ownership. 

KillIndic (ULONG) - input

Terminate indicator

Indicates whether the thread (with the outstanding VioSavRedrawUndo) should return an error code or be terminated.

 Value                    Definition 
  0                    Return error code. 
  1                    Terminate thread. 

VioHandle (HVIO) - input

Reserved. Must be 0.

Return Code

rc (APIRET) - returns

VioSavRedrawUndo returns one of the following values:

• 0 NO_ERROR
• 421 ERROR_VIO_INVALID_PARMS
• 422 ERROR_VIO_FUNCTION_OWNED
• 428 ERROR_VIO_NO_SAVE_RESTORE_THD
• 430 ERROR_VIO_ILLEGAL_DURING_POPUP

Remarks

The issuing thread can reserve ownership of VioSavRedrawWait for its process or give it up. The thread whose VioSavRedrawWait was canceled is optionally terminated. VioSavRedrawUndo can be issued only by a thread within the same process that owns VioSavRedrawWait. VioSavRedrawWait.

Related Functions

• [[OS2 API:CPI: