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

 PrnQueuePriorityChange()
------------------------------------------------------------------------------
 Purpose:
 Change the queue's service priority for a printer on the print server.

 Syntax:
 bResult = PrnQueuePriorityChange( wPtrNum,
          lpszServer, lpszQueue, wPriority )

 Parameters:
 wPtrNum    The printer number.
 lpszServer The file server name on which the queue exists.
 lpszQueue  The queue name.
 wPriority  The queue's priority level.

 Returns:
 A boolean value (TRUE or FALSE).

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

 Description:
 PrnQueuePriorityChange() changes the service priority of the printer
 queue lpszQueue on file server lpszServer for the service list of printer
 wPtrNum. wPriority is the new priority level.

 To call this function it is necessary to be logged into both the file
 server on which the queue exists and the print server on which the printer
 exists.

 The parameter wPriority is the priority level of the queue to the printer
 and can be in the range 1 to 255.

 If a printer services more than one queue, the jobs in the queues with the
 highest priorities are printed first.

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

 Example:
 //To log in to print server PRINTERS and change the priority of print
 // queue PRINTQ_0 on printer 0 to 10:
 if( PSWSLogin ( "PRINTERS" ) = 2 )
    if( PrnQueuePriorityChange ( 0, FSNameGet(), "PRINTQ_0", 10 ) )
       ? "The priority level of PRINTQ_0 on printer 0 of print"
       ? "server PRINTERS, is now set to 10"
    endif
 endif

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