NWChangeToClientRights2(3nw)


NWChangeToClientRights2 -- allows a queue server to change its current login identity to match the identity of the client for which it is acting

Synopsis

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

NWCCODE N_API NWChangeToClientRights2 (NWCONN_HANDLE conn, nuint32 queueID, nuint32 jobNumber);

Description

The parameters are as follows:

conn
(IN) Specifies the queue server connection handle.

queueID
(IN) Specifies the bindery object ID of the queue.

jobNumber
(IN) Specifies the job's number.

Return values

0x0000
SUCCESSFUL

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_NO_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,HARDWARE_FAILURE

Notices

The queue server's login user ID and associated security equivalence list are replaced by the ID and security equivalence list of the user who placed the job in the queue.

NWChangeToClientRights2 does not change any path mappings the queue server may have on the job server. However, all access rights to those directories are recalculated to conform to the rights of the queue client. Files opened before calling NWChangeToClientRights2 continue to be accessible with the server's rights. Files opened after calling NWChangeToClientRights2 are accessible only with the client's rights.

The job server creates path mappings needed to carry out the client's requests after calling NWChangeToClientRights2.

NWRestoreQueueServerRights reverses the effects of NWChangeToClientsRights2. The server's rights are automatically reset if the server calls NWFinishServicingQueueJob2 or NWAbortServicingQueueJob2.

Only a queue server that has previously accepted a job for service can call NWChangeToClientRights2.

Services

Queue Management

NCP calls

0x2222 23 17
Get File Server Information

0x2222 23 116
Change To Client Rights (no 1000 user support)

0x2222 23 133
Change To Client Rights (3.11 and above)

References

NWAbortServicingQueueJob2(3nw), NWFinishServicingQueueJob2(3nw), NWRestoreQueueServerRights(3nw)


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.