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

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

 Syntax:
 lpszMask = NovRightsString( iValue )

 Parameters:
 iValue The trustee assignment value.

 Returns:
 A character string of length 8.

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

 Description:
 NovRightsString() returns a character string containing a mask of trustee
 assignment letters for the given trustee assignment value iValue.

 NovRightsString() returns the mask for the version of NetWare that is
 running, e.g., the value 66 will return " R  F " on a NetWare 286 file
 server and " W  S " on a NetWare 386 file server.

 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 != NOVERRINT )
    ? "The character access mask for directory "
    ?? "SYS:PUBLIC is", NovRightsString( iRights )
 endif

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