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.