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

 PrnQueuePriorityGet()
------------------------------------------------------------------------------
 Purpose:
 Get the priority of a queue on a print server's printer.

 Syntax:
 iPriority = PrnQueuePriorityGet()

 Parameters:
 None.

 Returns:
 A numeric value (signed short int).

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

 Description:
 PrnQueuePriorityGet() works in conjunction with PrnQueueList() to return
 the service priority level of the last queue returned by PrnQueueList().
 The service priority level designates how important the queue is to the
 printer to which it is attached.

 PrnQueueList() is used to return a list of printer queues being serviced by
 a printer. Queues with the highest priority levels are serviced first.

 PrnQueuePriorityGet() can only be called after PrnQueueList(), which
 returns the priority of the latest queue returned by PrnQueueList().

 Example:
 // To log in to print server PRINTERS and list all the print queues, the
 // file servers they are on, and the queue priorities of printer 0:
 if( PSWSLogin ( "PRINTERS" ) > 0 )
    lpszQueue = PrnQueueList( 0, TRUE )
    do while !Empty( lpszQueue )
       ? "Print Queue ",lpszQueue," on server ",PrnQueueFSGet()
       ?? " priority ", PrnQueuePriorityGet()
       cQueue = PrnQueueList( 0, TRUE )
    enddo
 endif

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