NWPSComGetNotifyObject(3nw)


NWPSComGetNotifyObject -- returns names and intervals of object notified when printer needs attention

Synopsis

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

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

Description

The parameters are as follows:

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

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

sequence
(IN/OUT) Points to the index. sequence must be set to 0 before the first call; it is incremented by NWPSComGetNotifyObject on every return.

nServerName
(OUT) Points to the name of the object's NetWare server.

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

objectType
(OUT) Points to the type of object to be notified.

notifyDelay
(OUT) Points to the length of time before the first notice.

notifyInterval
(OUT) Points to the length of 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

0x030C
NWPSE_DOWN

0x030D
NWPSE_NOT_IN_LIST

0x030E
NWPSE_NO_RIGHTS

Notices

NWPSComGetNotifyObject returns NWPSE_NOT_IN LIST when there are no objects left in the notify list.

NWPSComGetNotifyObject is for operators and users.

Services

Print Server

NCP calls

None

References

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