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

 CapAutEndGet() / CapAutEndSet()
------------------------------------------------------------------------------
 Purpose:
 Get / set the capture auto end flag.

 Syntax:
 bFlag = CapAutEndGet( iLPTNum )
 bFlag = CapAutEndSet( iLPTNum, bNewFlag )

 Parameters:
 iLPTNum  The LPT device. 1=LPT1: 2=LPT2: 3=LPT3:
 bNewFlag The auto endcap on/off flag.

 Returns:
 A boolean value (TRUE or FALSE).

 Description:
 CapAutEndGet() returns the capture auto end flag, which determines when
 data from the program is sent to the network print queue.

 CapAutEndSet() sets the capture auto end flag to the value specified by
 bNewFlag for the specified LPT device iLPTNum and returns the previous
 setting.

 If set to FALSE, data is only sent to the print queue when you call
 CapFlush(), CapEnd() or exit the program. If set to TRUE (the usual value
 set up by the Supervisor), the data will be sent to the print queue when
 there has been no activity on that printer port for the period of time set
 by the CapTmeOutSet() function.

 If CapAutEndSet() is explicitly enabled CapTmeOutSet() should be set to
 15 or 30 seconds to ensure that output is not split into multiple jobs.

 Example:
 // To turn off capture auto end for LPT1:
 bPreviousFlag = CapAutEndSet( 1, FALSE )
 if ( NWErrorGet() = 0 )
    ? "Capture auto end has been switched off for LPT1:"
 endif

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