NWPSComAddNotifyObject(3nw)


NWPSComAddNotifyObject -- adds object to print server's notification list

Synopsis

   #include <nwps_com.h> 
   or 
   #include <nwpsrv.h> 
   

NWCCODE NWAPI NWPSComAddNotifyObject (WORD spxID, WORD printerID, char NWFAR *nServerName, char NWFAR *objectName, WORD objectType, WORD notifyDelay, WORD notifyInterval);

Description

The parameters are as follows:

spxID
(IN) Specifies the SPX connection to print server.

printerID
(IN) Specifies the printer (0 to maximum number of printers).

nServerName
(IN) Points to the name of the NetWare server.

objectName
(IN) Points to the name of object to be notified.

objectType
(IN) Specifies the type of object to be notified.

notifyDelay
(IN) Specifies the time before first notice.

notifyInterval
(IN) Specifies the time between notices.

Return values

0x0000
NWPSE_SUCCESSFUL

0x00ED
NWPSE_CONNECTION_TERMINATED

0x0103
NWPSE_BINDERY_LOCKED

0x0301
NWPSE_NOT_ENOUGH_MEMORY

0x0302
NWPSE_NO_SUCH_PRINTER

0x030A
NWPSE_NOT_ATTACHED_TO_SERVER

0x030B
NWPSE_ALREADY_IN_LIST

0x030C
NWPSE_DOWN

0x030E
NWPSE_NO_RIGHTS

Notices

The object is specified by nServerName, objectName, and objectType. OT_WILD indicates the job owner must be notified. The object must have an active connection ID to be notified.

Possible object type values are:

    1   =   OT_USER 
    2   =   OT_USER_GROUP 
   -1   =   OT_WILD 

NWPSComAddNotifyObject is for operators only.

Services

Print Server

NCP calls

None

References

NWPSComChangeNotifyInterval(3nw), NWPSComDeleteNotifyObject(3nw), NWPSComGetNotifyObject(3nw), NWPSComAttachToPrintServer(3nw), NWPSComLoginToPrintServer(3nw), NWScanObject(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.