NWPSComStopPrinter(3nw)


NWPSComStopPrinter -- stops a printer

Synopsis

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

NWCCODE NWAPI NWPSComStopPrinter (WORD spxID, WORD printerID, 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 minus 1).

jobOutcome
(IN) Specifies what to do after stopping the printer:

1
NWPS_RETURN_TO_QUEUE

2
NWPS_THROW_AWAY

Return values

0x0000
NWPSE_SUCCESSFUL

0x00ED
NWPSE_CONNECTION_TERMINATED

0x0301
NWPSE_NOT_ENOUGH_MEMORY

0x0302
NWPSE_NO_SUCH_PRINTER

0x0307
NWPSE_NOT_CONNECTED

0x030C
NWPSE_NO_RIGHTS

0x030E
NWPSE_DOWN

Notices

If the job returns to the queue, it restarts from the beginning. If the printer is already stopped and this packet is issued, it returns NWPSE_SUCCESSFUL.

NWPSComStopPrinter is for operators only.

Services

Print Server

NCP calls

None.

References

NWPSComAttachToPrintServer(3nw), NWPSComGetPrinterStatus(3nw), NWPSComLoginToPrintServer(3nw), NWPSComStartPrinter(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.