Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Novlib 3.30 Online Reference - <b> prnqueuelist()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 PrnQueueList()
------------------------------------------------------------------------------
 Purpose:
 Get a list of queues serviced by a printer on the print server.

 Syntax:
 lpszQueue = PrnQueueList( wPtrNum, bStartFlag )

 Parameters:
 wPtrNum    The printer number.
 bStartFlag The start of list flag

 Returns:
 A character string of length 47.

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

 Description:
 PrnQueueList() is used to obtain a list of print queues being serviced
 by printer wPtrNum on the currently logged into print server.

 PrnQueueList() is called initially with bStartFlag set to TRUE and then
 repeatedly with bStartFlag set to FALSE until PrnQueueList() returns an
 empty string, signifying the end of the list.

 PrnQueueList() returns an empty string on the first call if an error occurs
 or if the list is empty.

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

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

See Also: PrnQueueFSGet() PrnQueuePriorityGet() PSWSLogin() PSWSLogout()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson