NWRestoreQueueServerRights(3nw)


NWRestoreQueueServerRights -- restores queue server's identity

Synopsis

   #include <nwqms.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWRestoreQueueServerRights (NWCONN_HANDLE conn);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8999
DIRECTORY_FULL

0x89D0
ERR_Q_IO_FAILURE

0x89D1
ERR_NO_QUEUE

0x89D2
ERR_NO_Q_SERVER

0x89D3
ERR_NO_Q_RIGHTS

0x89D4
ERR_Q_FULL

0x89D5
ERR_NO_Q_JOB

0x89D6
ERR_NO_Q_JOB_RIGHTS

0x89D7
ERR_Q_IN_SERVICE

0x89D8
ERR_Q_NOT_ACTIVE

0x89D9
ERR_Q_STN_NOT_SERVER

0x89DA
ERR_Q_HALTED

0x89DB
ERR_Q_MAX_SERVERS

0x89FF
Failure

Notices

After calling NWRestoreQueueServerRights, the queue server's login user ID and associated security equivalence list are restored to their original values.

NWRestoreQueueServerRights does not change any of the path mappings (directory bases) held by the queue server. However, access rights to those directories are adjusted to reflect the queue server's rights in those directories.

If the queue server has changed some of its path mappings as part of its efforts to service the queue job, the queue server must restore those directory bases.

Files opened using the client's rights before calling NWRestoreQueueServerRights continue to be accessible with the client's rights. Files opened after calling NWRestoreQueueServerRights are accessible only with rights of the queue server.

NWRestoreQueueServerRights does not need to be called if either NWAbortServicingQueueJob2 or NWFinishServicingQueueJob2 were called.

Only queue servers previously changing their identity by calling NWChangeToClientRights2 can call NWRestoreQueueServerRights.

Services

Queue Management

NCP calls

0x2222 23 117 Restore Queue Server Rights

 
 -------------------------------------------------- 
| 0x2222|  23|  117|  Restore Queue Server Rights | 
|-------|----|-----|------------------------------| 

References

NWChangeToClientRights2(3nw), NWAbortServicingQueueJob2(3nw), NWFinishServicingQueueJob2(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.