Click above to get retro games delivered to your door ever month!

 CapKeepGet() / CapKeepSet()
------------------------------------------------------------------------------
 Purpose:
 Enable / disable keeping of interrupted capture.

 Syntax:
 bFlag = CapKeepGet( iLPTNum )
 bFlag = CapKeepSet( iLPTNum, bNewFlag )

 Parameters:
 iLPTNum  The LPT device. 1=LPT1: 2=LPT2: 3=LPT3:
 bNewFlag The enable/disable keep flag.

 Returns:
 A boolean value (TRUE or FALSE).

 The CA-Clipper names for these functions are:
 CapKeepGet() / CapKeepSet()

 Description:
 CapKeepGet() returns whether print jobs on the specified LPT device
 iLPTNum will be printed if the capture is interrupted. This enables jobs
 to still be printed up to the point that the capture is interrupted.
 By default, NetWare cancels a print job if the capture is interrupted
 during processing.

 CapKeepSet() sets the keep flag to the value specified by bNewFlag and
 returns the previous setting.

 Example:
 // To return the current state of the keep flag on LPT2:
 bKeepFlag = CapKeepGet(1)
 if ( NWErrorGet() = 0 )
    ? "The keep flag on LPT2: is currently set to ", bKeepFlag
 endif
 // To enable the printing of an interrupted capture on LPT1:
 CapKeepSet( 1, TRUE )
 if (CapKeepGet( 1 ))
    ? "Printing of interrupted captures on LPT1: is now enabled"
 endif

 Notes:
 If FALSE is returned, check NWErrorGet().