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> queusrlst()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 QueUsrLst()
------------------------------------------------------------------------------
 Purpose:
 List the queue users.

 Syntax:
 lpszQueueUser = QueUsrLst( lpszQueueName, wIndex )

 Parameters:
 lpszQueueName The print queue name.
 wIndex        The offset into the list of users.

 Returns:
 A character string of length 47.

 Description:
 QueUsrLst() is used to obtain a list of a print queue's authorised
 users. lpszQueueName is the name of the print queue for which to return
 the user list, wIndex is the index into the list. QueUsrLst() should
 be called initially with wIndex set to 1, and then called repeatedly,
 incrementing wIndex each time, until an empty (NULL) string is returned.

 QueUsrLst() returns an empty (NULL) string on the first call if there are
 no queue users for the queue, or if an error occurs.

 Returns an empty string when the end of the list has been reached.

 Example:
 // To return a complete list of authorised users of print queue PRINTQ_0:
 wIndex = 1
 lpszQUsers = QueUsrLst( "PRINTQ_0", wIndex )
 do while ( NWErrorGet() = 0 )
    ? lpszQUsers
    wIndex++
    lpszQUsers = QueUsrLst( "PRINTQ_0", wIndex )
 enddo

 Notes:
 QueUsrLst() scans the Q_USERS set property value of the specified
 queue.

 After an empty string is returned, check NWErrorGet().

See Also: QueUsrAdd() QueUsrDel() QueUsrTst() SetPrpIDAdd() SetPrpIDDel() SetPrpValGet() / SetPrpValSet()

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