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.