Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- CA-Clipper Tools . Book 4-Appendices - <b>nnetrghmsk()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETRGHMSK()
 Returns the rights mask, dependent on the Netware version
------------------------------------------------------------------------------
 Syntax

     NNETRGHMSK([<cServer>|<nConId>]) --> cRightsMask

     Netware: 2.2 and 3.11

 Arguments

     <cServer>  Designates the name of the file server for which the
     rights mask is determined.  Your workstation must be attached to
     <cServer>.

     <nConId>  Designates the connection ID of your workstation on
     <cServer>.

 Returns

     NNETRGHMSK() returns a string that contains the rights symbols in a
     descending order of their bit significance.

 Description

     NOVELL NET RIGHTS MASK
     The possible rights and their definitions are interpreted differently
     under Novell 2.x and 3.x.  NNETRGHMSK() returns a character string that
     contains the symbols of the rights, dependent on the Netware version.
     The possible rights can be seen in the following tables.  The first
     letter of each keyword under "Definition" represents the symbol used by
     NNETRGHMSK().

     The following table contains the rights under Netware 2.x:

     Table 23.12:  Rights Coding under Netware 2.x
     ------------------------------------------------------------------------
     Bit     Definition     Description
     ------------------------------------------------------------------------
     1       READ           Read files
     2       WRITE          Write to files
     3       OPEN           Open files
     4       CREATE         Create new files
     5       DELETE         Delete files
     6       PARENTAL       Create new directories
     7       SEARCH         Search files in directories
     8       MODIFY         Modify files or attributes
     ------------------------------------------------------------------------

     The following table contains the possible rights under Netware 3.x:

     Table 23.13:  Rights Coding under Netware 3.x
     ------------------------------------------------------------------------
     Bit     Definition     Description
     ------------------------------------------------------------------------
     1       READ           Read files
     2       WRITE          Write to files
     3       RESERVED
     4       CREATE         Create new files
     5       ERASE          Delete files
     6       ACCESS CONTROL Trustee rights can be modified
     7       FILE SCAN      Search files in directories
     8       MODIFY         Modify files or attributes
     9       SUPERVISORY    All rights / can grant rights
     ------------------------------------------------------------------------

     The return value of NNETRGHMSK() can be used in the function BITTOC().

 Note

     .  NNETRGHTMSK() returns a constant that depends on the Netware
        version on the file server used.  The function does not return
        information about the access rights of the currently logged in user.

 Example

     In the following example, file server TEST286 runs under Netware 2.15
     and file server WORK386 runs under Netware 3.11:

     ? NNETRGHMSK('TEST286')   // Returns: MSPDCOWR
     ? NNETRGHMSK('WORK386')   // Returns: SMFAEC WR

See Also: NNETRIGHTS()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson