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.