VS_ChkAuth()         Checks the user's security authorization

Description:

  VS_ChkAuth() allows the programmer to ensure that only authorized
  users can access sensitive elements (functions) of an application.

Syntax:     

  l_Authorized = VS_ChkAuth( c_ReqdOpt )

Pass:       

  c_ReqdOpt is a character expression that the user must have in
  his/her "OPTIONS" field in the SECURITY.DBF (maintained via
  VS_MntPwd())

Return:     

  l_Authorized is a logical expression that will be set to .T. if
  the user has c_ReqdOpt anywhere in the OPTIONS field in his
  record in SECURITY.DBF.  If the user does not have c_ReqdOpt in
  his OPTIONS field in SECURITY.DBF, l_Authorized will be set to .F.

Notes:      

  You (the Super User) must setup each user's record in SECURITY.DBF
  through the use of VS_MntPwd().

Example:    

  IF .NOT. VS_ChkAuth("SECRET")
     VS_DIE("Sorry, you do not have the proper authorization","to
  perform this function!!")
  ENDIF
  ...
  ...

Usage:      

  VS_ChkAuth() MUST NOT be used prior to VS_Login().