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

 PrnFormTopMark()
------------------------------------------------------------------------------
 Purpose:
 Marks the top of the form on a printer with a line of characters.

 Syntax:
 bResult = PrnFormTopMark( wPtrNum, lpszChar )

 Parameters:
 wPtrNum  The printer number.
 lpszChar The marker character.

 Returns:
 A boolean value (TRUE or FALSE).

 The CA-Clipper name for this function is:
 PrnFrmTopMrk()

 Description:
 PrnFormTopMark() causes the print server to send a line of characters to
 the printer to mark where it calculates the top of the form to be. wPtrNum
 is the printer number of the currently logged into printer. lpszChar is
 the character used to draw the line, which is usually set to the '='
 character.

 Returns TRUE if successful, or FALSE if an error occurs.

 Example:
 // To log in to print server PRINTERS and mark the top of the form
 //loaded on printer 0 with a line of '+' characters:
 if( PSWSLogin ( "PRINTERS" ) > 0 )
    if( PrnFormTopMark( 0, "+" )
       ? "Printer 0's currently mounted form has been marked with "
       ? "a line of + characters to show where the print server "
       ? "thinks the top of the form is."
    endif
 endif

 Notes:
 It is only possible to be logged in to one print server at a time.