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

 CapResetStringGet() / CapResetStringSet()
------------------------------------------------------------------------------
 Purpose:
 Get or set the capture reset string.

 Syntax:
 lpszString=CapResetStringGet( iLPTNum )
 lpszString=CapResetStringSet( iLPTNum, lpszNewStr )

 Parameters:
 iLPTNum    The LPT device. 1=LPT1: 2=LPT2: 3=LPT3:
 lpszNewStr The new reset string.

 Returns:
 A character string of length 16.

 The CA-Clipper names for these functions are:
 CapResStrGet() / CapResStrSet()

 Description:
 CapResetStringGet() returns the reset string for the specified LPT device
 iLPTNum. The printer reset string normally consists of a series of escape
 codes sent to the printer from the calling workstation after each print
 job to change the printer settings.

 CapResetStringSet() sets the specified reset string to lpszNewStr for the
 specified LPT device iLPTNum and returns the previous reset string.
 Both functions return an empty string if an error occurs. The length of the
 reset string is controlled by the workstation shell and defaults to a
 maximum of 16 characters in length. To increase the length of the reset
 string, include the line:

 PRINT TAIL=<length>
 in the workstation's SHELL.CFG file.

 Example:
 // To reset an HP Laserjet compatible printer to its default
 // settings after each captured print job sent to LPT1:
 lpszResetString = chr(27)+"E"
 // ESC E is the reset code for HP LaserJet printers
 CapResetStringSet( 1, lpszResetString )
 if( NWErrorGet() = 0 )
    ? "The HPLaserJet being captured to on LPT1 will be "
    ? "reset after each print job"
 endif

 Notes:
 If an empty string is returned, check NWErrorGet().