Tabla ImageFamilies (Patchwiz.dll)

Una familia de imágenes es un grupo de una o varias imágenes actualizadas de un producto que se han actualizado a la versión más reciente. Cada imagen actualizada solo puede pertenecer a una familia. Las imágenes actualizadas que pertenecen a una familia de imágenes comparten uno o varios archivos. Cada familia de imágenes tiene su propio archivo .cab en el archivo .msp que contiene las revisiones binarias y los nuevos archivos necesarios para actualizar las diferencias entre el archivo de destino y el actualizado. El archivo .cab no replica las revisiones binarias y los nuevos archivos que usan los archivos compartidos.

Se requiere una tabla ImageFamilies que contenga al menos un registro en cada base de datos de creación de revisiones (archivo .pcp). La función UiCreatePatchPackageEx usa esta tabla.

La tabla ImageFamilies contiene la información de aplicación de revisiones que se va a agregar a la tabla llamada Media. Una revisión agrega una entrada a la tabla Media. Cada registro de las tablas ImageFamilies hace referencia a un grupo de imágenes de producto relacionadas que se han actualizado a la versión más reciente del producto.

La tabla ImageFamilies tiene las siguientes columnas. Se puede usar un valor null en las columnas MediaSrcPropName, MediaDiskId y FileSequenceStart si la revisión se aplica con Windows Installer y Patchwiz.dll versión 2.0.

Columnas

Family

El valor especificado en este campo es un identificador de un grupo de imágenes de producto relacionadas que se han actualizado a la versión más reciente del producto. Está limitado a un total de 8 caracteres alfanuméricos o caracteres de subrayado. El instalador inserta una secuencia de un archivo .cab en el archivo de revisión de Windows Installer (archivo .msp) para cada familia de la tabla. El archivo .cab contiene las revisiones binarias y los nuevos archivos necesarios para actualizar una imagen de destino en una imagen actualizada del producto. El instalador agrega el prefijo PCW_CAB_ al nombre de la familia para generar el nombre de la secuencia del archivo .cab que escribe en el campo Archivo .cab de la nueva entrada de la tabla Media.

MediaSrcPropName

Valor especificado en el campo Origen de la nueva entrada de la tabla Media de la imagen actualizada. Este campo solo puede ser null si usa la versión 2.0 de Patchwiz.dll y si MinimumRequiredMsiVersion en la tabla Properties (Patchwiz.dll) está establecido en 200.

MediaDiskId

El instalador escribe este valor en el campo DiskId del nuevo registro de la tabla Media. El valor de DiskID debe ser mayor que cualquier DiskID actual del paquete de destino. El límite de MediaDiskId es 32767. Este campo solo puede ser null si usa la versión 2.0 de Patchwiz.dll y si MinimumRequiredMsiVersion en la tabla Properties (Patchwiz.dll) está establecido en 200.

FileSequenceStart

Este campo es el número de secuencia del archivo de inicio. Este mismo número de secuencia de archivo no debe existir en dos revisiones del mismo producto. Para garantizar esto, el valor de este campo debe ser mayor que todos los números de secuencia usados en revisiones anteriores o en el paquete de instalación original. El mayor número de secuencia de una revisión se puede determinar agregando el número total de entradas del archivo .cab de revisión al número de FileSequenceStart de esa revisión. Una manera de determinar esto es examinar el archivo .ddf que generó Patchwiz.dll durante la creación de la revisión. El límite de FileSequenceStart es 32 767. Este campo solo puede ser null si usa la versión 2.0 de Patchwiz.dll y si MinimumRequiredMsiVersion en la tabla Properties (Patchwiz.dll) está establecido en 200.

DiskPrompt

El instalador escribe este valor en el campo DiskPrompt del nuevo registro de la tabla Media.

VolumeLabel

El instalador escribe este valor en el campo VolumeLabel del nuevo registro de la tabla Media.

Observaciones

La revisión agrega el nombre del archivo .cab en el archivo .msp al campo Archivo .cab del nuevo registro agregado a la tabla Media. Como se trata de un archivo .cab insertado, el nombre tiene el prefijo "#". La revisión agrega una propiedad al campo Origen del nuevo registro de la tabla Media. Dos revisiones nunca pueden tener la misma propiedad de origen.

Los archivos que se comparten dentro de la familia de imágenes deben tener la misma clave de tabla de archivos en cada imagen actualizada de la familia. Las claves de tabla de archivos compartidas entre las imágenes actualizadas deben representar el mismo archivo y deben ser idénticas en todas las imágenes actualizadas. La clave de tabla de archivos es el valor especificado en la columna Archivo de la tabla Archivo.

El límite de MediaDiskId y FileSequenceStart es 32 767. Para aumentar este límite, exporte la tabla ImageFamilies a un archivo .idt con Msidb.exe y cambie el tipo de columna de i2 a i4, o de I2 a I4 y, a continuación, importe el archivo .idt de nuevo en la base de datos .pcp. No se pueden crear transformaciones y revisiones entre dos paquetes con tipos de columna diferentes.