Click above to get retro games delivered to your door ever month!

 NovRightsValue()
------------------------------------------------------------------------------
 Purpose:
 Get a rights value for a trustee rights mask.

 Syntax:
 iValue = NovRightsValue( lpszMask )

 Parameters:
 lpszMask A character string representing the trustee assignment value.

 Returns:
 A numeric value (signed short integer).

 The CA-Clipper name for this function is:
 NovRgtVal()

 Description:
 NovRightsValue() is used to convert a character string representation of
 the trustee assignment into a numeric value.

 The complete mask for NetWare 286 is: "RWOCDPSM"

 Attribute         Position    Value

 R = Read             1        1
 W = Write            2        2
 O = Open             3        4
 C = Create           4        8
 D = Delete           5        16
 P = Parental         6        32
 S = Search           7        64
 M = Modify           8        128

 The complete mask for NetWare 386 is: "SRWCEMFA"

 Attribute         Position    Value

 S = Supervisory      1        256
 R = Read             2        1
 W = Write            3        2
 C = Create           4        8
 E = Erase            5        16
 M = Modify           6        128
 F = File Scan        7        64
 A = Access Control   8        32

 Example:
 // To return the character mask for the rights of the current
 // user to directory SYS:PUBLIC:
 iRights = DirEffectiveRightsGet( "SYS:PYBLIC" )
 if ( iRights != NOVERRLONG )
    ? "The character access mask for directory "
    ?? "SYS:PUBLIC is", NovRightsString( iRights )
 endif

 Notes:
 For more information on trustee values see the Appendix.