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.