NWPSComDownPrintServer(3nw)


NWPSComDownPrintServer -- shuts down print server

Synopsis

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

NWCCODE NWAPI NWPSComDownPrintServer (WORD spxID, BYTE immediate, BYTE jobOutcome);

Description

The parameters are as follows:

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

immediate
(IN) Specifies whether to shut down immediately: 0=NO; 1=YES.

jobOutcome
(IN) Specifies what to do after shut down: 1 = NWPS_RETURN_TO_QUEUE; 2 = NWPS_THROW_AWAY. jobOutcome is used only if immediate is YES.

Return values

0x0000
NWPSE_SUCCESSFUL

0x00ED
NWPSE_CONNECTION_TERMINATED

0x0301
NWPSE_NOT_ENOUGH_MEMORY

0x0303
NWPSE_INVALID_PARAMETER

0x030C
NWPSE_DOWN

0x030E
NWPSE_NO_RIGHTS

Notices

Before it shuts down, the print server checks the value of jobOutcome dealing with the job accordingly, stops the printer, and, depending on the value of immediate, advertises its status with GOING_DOWN or DOWN. jobOutcome must be a valid number.

NWPSComDownPrintServer does not terminate the SPX connection unless the print server goes down before it returns its completion code. The next call after the print server is downed returns NWPSE_CONNECTION_TERMINATED.

NWPSComDownPrintServer is for operators only.

Services

Print Server

NCP calls

None

References

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