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
Send comments about this topic to Microsoft
Build date: 8/13/2009
© 2009 Microsoft Corporation. All rights reserved.