NWPSComDeleteQueueFromPrinter(3nw)
NWPSComDeleteQueueFromPrinter --
deletes queue from printer's service list
Synopsis
#include <nwps_com.h>
or
#include <nwpsrv.h>
NWCCODE NWAPI NWPSComDeleteQueueFromPrinter
(WORD spxID,
WORD printerID,
char NWFAR *nServerName,
char NWFAR *queueName,
BYTE detach,
BYTE jobOutcome);
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).
- nServerName
-
(IN) Points to the name of the object's NetWare server.
- queueName
-
(IN) Points to the name of the queue to be deleted.
- detach
-
(IN) Specifies whether to detach: 0=NO; 1=YES.
- jobOutcome
-
(IN) Specifies the what to do after the queue is deleted: 1 =
NWPS_RETURN_TO_QUEUE; 2 = NWPS_THROW_AWAY.
jobOutcome is used only if detach is YES.
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
- 0x030C
-
NWPSE_DOWN
- 0x030D
-
NWPSE_NOT_IN_LIST
- 0x030E
-
NWPSE_NO_RIGHTS
Notices
The server must be attached to the NetWare server where the queue exists.
If a print server is servicing a job from the queue,
NWPSComDeleteQueueFromPrinter aborts the job using
jobOutcome.
NWPSComDeleteQueueFromPrinter is for operators only.
Services
Print Server
NCP calls
None
References
NWPSComAddQueueToPrinter(3nw),
NWPSComAttachToPrintServer(3nw),
NWPSComChangeQueuePriority(3nw),
NWPSComDeleteQueueFromPrinter(3nw),
NWPSComGetPrintersServicingQ(3nw),
NWPSComGetQueuesServiced(3nw),
NWPSComLoginToPrintServer(3nw),
NWScanObject(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.