FamilyFileRanges Table (Patchwiz.dll)
The FamilyFileRanges table contains information about particular files of an upgraded image with ranges that should never be overwritten. This table is optional in the patch creation database (.pcp file) and is used by the UiCreatePatchPackageEx function.
The FamilyFileRanges table has the following columns.
| Column | Type | Key | Nullable |
|---|---|---|---|
| Family | text | Y | N |
| FTK | text | Y | N |
| RetainOffsets | text | N | |
| RetainLengths | text | N |
Columns
-
Family
-
Foreign key to the Family column of the ImageFamilies Table (Patchwiz.dll).
-
FTK
-
Foreign key into the File tables of all the upgraded images in the image family.
-
RetainOffsets
-
The offset of the ranges that cannot be overwritten. The value in this field is a list of the range offset numbers for ranges that are not to be overwritten in the target files. The order and number of the ranges in the list must match the items in the RetainLengths column.
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.
-
RetainLengths
-
The length in bytes of the ranges that cannot be overwritten. The value in this field is a list of range length numbers for ranges to retain in target files. The order and number of the ranges in the list must match the items in the RetainOffsets column.
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.
Remarks
The offsets and lengths entered in RetainOffsets and RetainLengths must not specify overlapping ranges.
Related topics