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> prnnotifyperiodchange()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 PrnNotifyPeriodChange()
------------------------------------------------------------------------------
 Purpose:
 Change an object's notify period on a printer on the print server.

 Syntax:
 bResult = PrnNotifyPeriodChange( wPtrNum, lpszServer,
       lpszName, wFirst, wNext, wObjType )

 Parameters:
 wPtrNum    The printer number.
 lpszServer The file server on which the object exists.
 lpszName   The object's name.
 wFirst     The first notify period
 wNext      The subseqent notify period.
 wObjType   The object's type.

 Returns:
 A boolean value (TRUE or FALSE).

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

 Description:
 PrnNotifyPeriodChange() changes an object's notify period on the notify
 list of a specific printer. The notify list determines which objects
 will be notified if the printer needs attention, e.g. out of paper,
 form needs changing etc.

 To call this function it is first necessary to login to the print server
 using the PSWSLogin() function.

 wPtrNum is the printer number on the print server, lpszServer is the file
 server name on which the object lpszName exists, lpszName is the object
 name. wFirst is the new length of time, in seconds, between the problem
 occuring on the printer and the object being notified. wNext is the new
 length of time, in seconds, between notifications that will occur until the
 problem is resolved. wObjType is the object type for parameter lpszName.
 PrnNotifyPeriodChange() returns TRUE if successful, or FALSE if an error
 occurs.

 Example:
 // To log in to print server PRINTERS and change user KATIE's
 // notification times for printer 0 on server BLINK so that after 10
 // seconds of the problem occurring user KATIE will be notified of the
 // problem, and thereafter every 20 seconds until the problem is resolved:
 if( PSWSLogin( "PRINTERS" ) = 2 )
    if( PrnNotifyPeriodChange(0, "BLINK", "KATIE", 10, 20, OT_USER)
       ?  "User KATIE on server BLINK will now be notified "
       ?? "after 10 seconds if printer 0 on print server "
       ?? "PRINTERS requires attention, and every 20 "
       ?? "seconds thereafter until the problem is resolved."
    endif
 endif

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

 This function requires that the calling user has print server operator
 status.

See Also: PrnNotifyObjectDelete() PrnNotifyObjectAdd() PSWSLogin() PrnNotifyObjectList()

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