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.
See Also
- Patching Selected Regions of a File
Send comments about this topic to Microsoft
Build date: 11/12/2009