NWGetBinderyAccessLevel(3nw)


NWGetBinderyAccessLevel -- returns the access level of the current logged-in entity based on the specified connection handle

Synopsis

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

NWCCODE N_API NWGetBinderyAccessLevel (NWCONN_HANDLE conn, pnuint8 accessLevel, pnuint32 objID);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

accessLevel
(OUT) Points to the current security access mask for the given connection (optional).

objID
(OUT) Points to the object ID of the current logged in entity (optional).

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8996
SERVER_OUT_OF_MEMORY

Notices

A process' access level determines which bindery objects and properties the process can find and manipulate.

accessLevel is a byte in which the low nibble indicates Read security and the high nibble indicates Write security. Read security controls which objects and properties the workstation can find when it scans the bindery. Write security controls which objects and properties the workstation can modify.

The following table below summarizes security values:

Read Value Write Value Access Level Description
BS_ANY_READ BS_ANY_WRITE Anyone Access allowed to all clients, even if the client has not logged in to the server.
BS_LOGGED_READ BS_LOGGED_WRITE Logged Access allowed to all clients logged in to the server.
BS_OBJECT_READ BS_OBJECT_WRITE Object Access allowed only to clients who have logged in to the server with object's name, type, and password.
BS_SUPER_READ BS_SUPER_WRITE SUPERVISOR Access allowed only to clients who have logged in to the server as SUPERVISOR, or as a bindery object security-equivalent to SUPERVISOR.
BS_BINDERY_READ BS_BINDERY_WRITE NetWare Access allowed only to NetWare.

 
 Read Value        Write Value        Access Level   Description 
 BS_ANY_READ       BS_ANY_WRITE       Anyone         Access allowed 
                                                     to all clients, 
                                                     even if the 
                                                     client has not 
                                                     logged in to 
                                                     the server. 
 BS_LOGGED_READ    BS_LOGGED_WRITE    Logged         Access allowed 
                                                     to all clients 
                                                     logged in to 
                                                     the server. 
 BS_OBJECT_READ    BS_OBJECT_WRITE    Object         Access allowed 
                                                     only to clients 
                                                     who have logged 
                                                     in to the 
                                                     server with 
                                                     object's name, 
                                                     type, and 
                                                     password. 
 BS_SUPER_READ     BS_SUPER_WRITE     SUPERVISOR     Access allowed 
                                                     only to clients 
                                                     who have logged 
                                                     in to the 
                                                     server as 
                                                     SUPERVISOR, or 
                                                     as a bindery 
                                                     object 
                                                     security- 
                                                     equivalent to 
                                                     SUPERVISOR. 
 BS_BINDERY_READ   BS_BINDERY_WRITE   NetWare        Access allowed 
                                                     only to 
                                                     NetWare. 

Values can be ORed together. For example, accessLevel BS_SUPER_WRITE ORed with BS_LOGGED_READ (Hex 0x31) indicates the requesting workstation can successfully log in to the NetWare server but does not have SUPERVISOR security equivalence. This client is allowed access to objects having BS_LOGGED or BS_OBJECT Read security.

Services

Bindery

NCP calls

0x2222 23 70
Get Bindery Access Level

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