ImageFamilies Table (Patchwiz.dll)

Une famille d’images est un groupe d’une ou plusieurs images mises à niveau d’un produit qui ont été mises à jour vers la version la plus récente. Chaque image mise à niveau ne peut appartenir qu’à une seule famille. Les images mises à niveau appartenant à une famille d’images partagent un ou plusieurs fichiers. Chaque famille d’images possède son propre fichier d’armoire dans le fichier .msp contenant les correctifs binaires et les nouveaux fichiers nécessaires pour mettre à jour les différences entre les fichiers cibles et mis à niveau. Le fichier d’armoire ne réplique pas les correctifs binaires et les nouveaux fichiers utilisés par les fichiers partagés.

Une table ImageFamilies contenant au moins un enregistrement est requise dans chaque base de données de création de correctifs (fichier .pcp). Cette table est utilisée par la fonction UiCreatePatchPackageEx.

La table ImageFamilies contient les informations de mise à jour corrective à ajouter à la table media . Un correctif ajoute une entrée à la table Media. Chaque enregistrement dans les tables ImageFamilies fait référence à un groupe d’images de produit associées qui ont été mises à jour vers la version la plus récente du produit.

La table ImageFamilies comporte les colonnes suivantes. Une valeur Null peut être utilisée dans les colonnes MediaSrcPropName, MediaDiskId et FileSequenceStart si le correctif est appliqué avec Windows Installer et Patchwiz.dll version 2.0.

Colonnes

famille

La valeur entrée dans ce champ est un identificateur d’un groupe d’images de produit associées qui ont été mises à jour vers la version la plus récente du produit. Limité à un total de 8 caractères alphanumériques ou traits de soulignement. Le programme d’installation incorpore un flux d’armoire dans le fichier correctif Windows Installer (fichier .msp) pour chaque famille de la table. L’armoire contient les correctifs binaires et les nouveaux fichiers nécessaires pour mettre à jour une image cible dans une image mise à niveau du produit. Le programme d’installation préfixe le nom de famille avec PCW_CAB_ pour générer le nom de flux du cabinet qu’il entre dans le champ Cabinet de la nouvelle table media entrée.

MediaSrcPropName

Valeur entrée dans le champ Source de la nouvelle table media entrée de l’image mise à niveau. Ce champ ne peut être null que si vous utilisez la version 2.0 de Patchwiz.dll et si minimumRequiredMsiVersion dans la table propriétés (Patchwiz.dll) est défini sur 200.

MediaDiskId

Le programme d’installation entre cette valeur dans le champ DiskId du nouvel enregistrement table media. La valeur DiskID doit être supérieure à n’importe quel DiskID actuel dans le package cible. La limite de MediaDiskId est 32767. Ce champ ne peut être null que si vous utilisez la version 2.0 de Patchwiz.dll et si minimumRequiredMsiVersion dans la table propriétés (Patchwiz.dll) est défini sur 200.

FileSequenceStart

Ce champ est le numéro de séquence du fichier de départ. Ce même numéro de séquence de fichiers ne doit pas exister dans deux correctifs pour le même produit. Pour ce faire, la valeur de ce champ doit être supérieure à tous les numéros de séquence utilisés dans les correctifs précédents ou dans le package d’installation d’origine. Le plus grand nombre de séquences dans un correctif peut être déterminé en ajoutant le nombre total d’entrées dans le fichier d’armoire de correctif au numéro FileSequenceStart pour ce correctif. Une façon de déterminer cela consiste à examiner le fichier .ddf généré par Patchwiz.dll lors de la création du correctif. La limite de FileSequenceStart est 32767. Ce champ ne peut être null que si vous utilisez la version 2.0 de Patchwiz.dll et si minimumRequiredMsiVersion dans la table propriétés (Patchwiz.dll) est défini sur 200.

DiskPrompt

Le programme d’installation entre cette valeur dans le champ DiskPrompt de la nouvelle table media enregistrement.

VolumeLabel

Le programme d’installation entre cette valeur dans le champ VolumeLabel du nouvel enregistrement Media.

Remarques

Le correctif ajoute le nom de l’armoire dans le fichier .msp au champ Cabinet du nouvel enregistrement ajouté à la table media . Étant donné qu’il s’agit d’une armoire incorporée, le nom est précédé d’un caractère « # ». Le correctif ajoute une propriété au champ Source du nouvel enregistrement dans la table Media. Aucun de deux correctifs n’a peut-être la même propriété source.

Les fichiers partagés dans la famille d’images doivent avoir la même clé de table de fichiers dans chaque image mise à niveau de la famille. Toutes les clés de table de fichiers partagées entre les images mises à niveau doivent représenter le même fichier et doivent être identiques dans toutes les images mises à niveau. La clé de table de fichiers est la valeur entrée dans la colonne Fichier de la table fichier .

La limite pour MediaDiskId et FileSequenceStart est 32767. Pour augmenter cette limite, exportez la table ImageFamilies vers un fichier .idt avec Msidb.exe et modifiez le type de colonne i2 vers i4, ou de I2 à I4, puis importez le fichier .idt dans la base de données .pcp. Les transformations et les correctifs ne peuvent pas être créés entre deux packages ayant des types de colonnes différents.