ExternalFiles Table (Patchwiz.dll)
The ExternalFiles table contains information about specific files that are not part of a regular target image. These files may exist in products that have been updated by another product, upgrade, or patch. This table is optional in the patch creation database (.pcp file) and is used by the UiCreatePatchPackageEx function.
The ExternalFiles table has the following columns.
| Column | Type | Key | Nullable |
|---|---|---|---|
| Family | text | Y | N |
| FTK | text | Y | N |
| FilePath | text | Y | N |
| SymbolPaths | text | Y | |
| IgnoreOffsets | text | Y | |
| IgnoreLengths | text | Y | |
| RetainOffsets | text | N | |
| Order | integer | Y |
Columns
-
Family
-
Foreign key to the Family column of the ImageFamilies Table (Patchwiz.dll).
-
FTK
-
Foreign key into File table of the .msi file of the upgraded image.
-
FilePath
-
Full path of the external file including the file name. FilePath field is used to locate the file specified in the FTK column.
-
SymbolPaths
-
Full path searched for symbol files of the file specified in the FTK column.
-
IgnoreOffsets
-
The value in this field is a comma-delimited list of range offset numbers for the ranges to be ignored in the external file. The order and number of the ranges in the list must match the items in the IgnoreLengths column. This column is optional.
The values can be decimal or hexadecimal. Patchwiz.dll treats the value as hexadecimal if it is prefixed by "0x". The columns are string columns and Patchwiz.dll will convert the values to ULONGs.
-
IgnoreLengths
-
The value in this field is a comma-delimited list of range lengths in bytes for the ranges to be ignored in the external file. The order and number of the ranges in the list must match the items in the IgnoreOffsets column. This column is optional.
The values can be decimal or hexadecimal. Patchwiz.dll treats the value as hexadecimal if it is prefixed by "0x". The columns are string columns and Patchwiz.dll will convert the values to ULONGs.
-
RetainOffsets
-
The value in this field is a comma-delimited list of range offset numbers for the ranges to be retained in the External file. The order and number of the ranges in the list must match the items in the RetainOffsets column of the corresponding record in the FamilyFileRanges Table (Patchwiz.dll).
The values can be decimal or hexadecimal. Patchwiz.dll treats the value as hexadecimal if it is prefixed by "0x". The columns are string columns and Patchwiz.dll will convert the values to ULONGs.
-
Order
-
If two or more versions are specified for the same external file, the table may contain multiple records with matching values in the FTK and Family fields. In this case, the Order field may specify the order of external files to use when creating the patch. The order is from the oldest to the most recent version.
Remarks
This table accepts environment variables as paths beginning with version 4.0 of Patchwiz.dll.
Related topics