NWPSComDetachPServerFromNServer(3nw)
NWPSComDetachPServerFromNServer --
detaches print server from NetWare server
Synopsis
#include <nwps_com.h>
or
#include <nwpsrv.h>
NWCCODE NWAPI NWPSComDetachPServerFromNServer
(WORD spxID,
char NWFAR *nServerName,
BYTE detach,
BYTE jobOutcome);
Description
The parameters are as follows:
- spxID
-
(IN) Specifies the SPX connection to the print server.
- nServerName
-
(IN) Points to the name of the object's NetWare server.
- detach
-
(IN) Specifies whether to detach: 0=NO; 1=YES.
- jobOutcome
-
(IN) Specifies what to do after detaching: 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
- 0x0305
-
NWPSE_CANT_DETACH_PRIMARY_SERVE
- 0x030A
-
NWPSE_NOT_ATTACHED_TO_SERVER
- 0x030C
-
NWPSE_DOWN
- 0x030E
-
NWPSE_NO_RIGHTS
Notices
If detach is set to YES and a job is being serviced, the print
server acts according to the jobOutcome flags.
If detach is set to NO and a job is being serviced, the print
server remains attached to the NetWare server even though
NWPSComDetachPServerFromNServer has returned SUCCESSFUL,
and detaches when the job has finished.
Before detaching, NWPSComDetachPServerFromNServer detaches all
of the print server's printers from queues on the NetWare server. If any
printers are servicing queues, it waits until they are finished before
it detaches them. It also deletes the notify objects on the NetWare server
after it detaches.
NWPSComDetachPServerFromNServer is for operators only.
Services
Print Server
NCP calls
None
References
NWPSComAttachPServerToNServer(3nw),
NWPSComAttachToPrintServer(3nw),
NWPSComLoginToPrintServer(3nw),
NWScanObject(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.