DrLocator Table

[This is preliminary documentation and subject to change.]

The DrLocator table holds the information needed to find a file or directory by searching the directory tree.

The DrLocator table has the following columns.

Column Type Key Nullable
Signature_ Identifier Y N
Parent Identifier Y Y
Path AnyPath Y Y
Depth Integer Y

Columns

Signature_
The Signature_ represents a unique file signature and is also the external key into the Signature table. If the key is absent from the Signature table, the search is assumed to be for the presence of a directory pointed to by the DrLocator table.

External key to column one of the Signature table.

Parent
The parent directory signature. This is a key into one of the following tables: RegLocator table, the IniLocator table, the CompLocator table, or the DrLocator table. If it is Null and the Path column does not expand to a full path, all the fixed drives of the user system are searched using the Path.
Path
The path on the user system. This is a either a subpath below the value of the Parent or a full path. The path may contain properties enclosed within square brackets ([ ]) that are expanded.
Depth
The depth below the path to which the Signature_ is recursively searched. If absent, the depth is assumed to be zero.

Non-negative numbers only.

Remarks

This table's columns are generally not localized. If an author decides to search for products in multiple languages, then there can be a separate entry included in the table for each language.