FN_RIGHTS()
 Get effective rights to any directory (Netware, Local)
------------------------------------------------------------------------------
 Syntax
 
      fn_Rights( <cDirectory> ) -> <cRights>
 
 Arguments

     <cDirectory> corresponds to a directory path, including drive letter

 Returns

     <cRights> returns a string of rights (RWOCDPSM), or "" for invalid drives.

 Description

     This call returns the current rights for a directory, local or Netware.
     It is a high level call that checks the drive type before calling the
     fn_getrights() function.  It assumes the user has full rights to the
     local drive.
     R - Read
     W - Write
     O - Open
     C - Create
     D - Delete
     P - Parental
     S - Scan
     M - Modify

 Examples
       function main( cDirectory )

          local cRights

          cRights := fn_Rights( cDirectory )

       return(NIL)


 Source: N:\SRC\FSYS\RIGHTS.PRG

 Author: Michael A. Cohen