Edit

FamilyFileRanges Table (Patchwiz.dll)

  • Article

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.

Patching Selected Regions of a File