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> prnnotifyobjectlist()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 PrnNotifyObjectList()
------------------------------------------------------------------------------
 Purpose:
 Get a list of notify objects for a printer on the print server.

 Syntax:
 lpszObj = PrnNotifyObjectList( wPtrNum, bStartFlag )

 Parameters:
 wPtrNum    The printer number.
 bStartFlag Flag signifying the start of the list.

 Returns:
 A character string of length 47.

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

 Description:
 PrnNotifyObjectList() is used to obtain a list of object names that will
 be notified if printer wPtrNum on the current print server needs attention.

 PrnNotifyObjectList() is called the first time with the parameter wPtrNum
 set to the printer number and bStartFlag set to TRUE and then called
 repeatedly with bStartFlag set to FALSE until an empty (null) string is
 returned. If PrnNotifyObjectList() returns an empty string on the first
 call, it means there are no objects in the list.

 PrnNotifyObjectList() returns an empty string if an error occurs or if it
 has reached the end of the list.

 Example:
 // To log in to print server PRINTERS and list all objects that will be
 // notified if printer 0 has a problem:
 if( PSWSLogin ( "PRINTERS" ) > 0 )
    lpszName = PrnNotifyObjectList( 0, TRUE )
    do while !empty( lpszName )
       ? lpszName
       lpszName = PrnNotifyObjectList( 0, FALSE )
    enddo
 endif

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

See Also: PSWSLogin() PrnNotifyObjectAdd() PrnNotifyObjectDelete() NfyObjectFirstIntervalGet() NfyObjectNextIntervalGet()

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