Contains the full path to the folder where shared files or folders may be located for dBASE Plus or for a dBASE Plus application.

Property of

_app object

Description

allUsersPath is set during startup to a subfolder of the special Window's folder intended to hold files or folders that may be shared by all authenticated users.

An application may install files and folders under this folder which contain data shared by all users of an application - such as shared configuration settings, shared images or other resources, and other shared data files.  In addition, master copies of files that will be copied for each user into their private folder tree, can be installed here as well.

How allUsersPath is set

During startup dBASE or the dBASE runtime engine retrieves the current user's shared application folder path from Windows.  The Windows designation for this path is: CSIDL_COMMON_APPDATA.

The path retrieved looks like one of the following paths:

   On Windows XP,

         C:\Documents and Settings\All Users\Application Data

   On newer versions of Windows, this folder defaults to:

      C:\ProgramData

Next, the subpath is determined based on the folder from which dBASE or an application  .exe was launched.

If launched from under \Program Files or \Program Files (x86), the path remaining after dropping this initial folder is appended to the shared application folder path.

   For example, when running dBASE Plus from its default location:

   On Windows XP, allUsersPath is set to:

      C:\Documents and Settings\All Users\Application Data\dBASE\PLUS\BIN

   On newer versions of Windows, allUsersPath is set to:

      C:\ProgramData\dBASE\PLUS\BIN

If launched from some other folder, the path remaining after dropping the initial drive specifier or UNC path is appended to the shared application folder path.

   For example, when running a dBASE application from:

      C:\MyApp\myapp.exe

   allUsersPath will be set as follows:

      On Windows XP:  C:\Documents and Settings\All Users\Application Data\MyApp

      On newer versions of Windows: C:\ProgramData\MyApp

   When running a dBASE application via a UNC path:

      \\SomeUNC\MyApp\myapp.exe

   allUsersPath will be set as follows:

      On Windows XP:  C:\Documents and Settings\All Users\Application Data\MyApp

      On newer versions of Windows: C:\ProgramData\MyApp