Table ImageFamilies (Patchwiz.dll)

Une famille d’images est un groupe d’une ou plusieurs images mises à niveau d’un produit qui a été mis à 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 a 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 les fichiers 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 qui doivent être ajoutées à 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.

Le tableau UpgradedImages comporte les colonnes suivantes. Une valeur nulle 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.

Colonne	Type	Clé	Nullable
Famille	texte	O	N
MediaSrcPropName	texte		O
MediaDiskId	entier		O
FileSequenceStart	entier		O
DiskPrompt	texte		O
VolumeLabel	texte		O

 

Colonnes

Famille

La valeur entrée dans ce champ est un identificateur pour 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’armoires dans le fichier correctif Windows Installer (fichier .msp) pour chaque famille de la table. L’armoire contient les correctifs binaires et les nouveaux fichiers requis pour mettre à jour une image cible dans une image mise à niveau du produit. Le programme d’installation précède le nom de famille avec PCW_CAB_ pour générer le nom de flux de l’armoire qui sera entré dans le champ Cabinet de la nouvelle entrée de table Media .

MediaSrcPropName

Valeur entrée dans le champ Source de la nouvelle entrée de table Media de l’image mise à niveau. Ce champ ne peut être de valeur nulle que si vous utilisez la version 2.0 de Patchwiz.dll et si la valeur MinimumRequiredMsiVersion de la table Properties (Patchwiz.dll) est définie sur 200.

MediaDiskId

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

FileSequenceStart

Ce champ correspond au numéro de séquence du fichier de départ. Ce même numéro de séquence de fichier ne doit pas apparaître dans deux correctifs pour le même produit. Pour cela, 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 numéro de séquence le plus élevé d’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 correspondant à ce correctif. Une façon de le déterminer consiste à examiner le fichier .ddf généré par Patchwiz.dll lors de la création du correctif. La limite pour FileSequenceStart est 32767. Ce champ ne peut être de valeur nulle que si vous utilisez la version 2.0 de Patchwiz.dll et si la valeur MinimumRequiredMsiVersion de la table Properties (Patchwiz.dll) est définie sur 200.

DiskPrompt

Le programme d’installation entre cette valeur dans le champ DiskId du nouvel enregistrement de table Média .

VolumeLabel

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

Notes

Le correctif ajoute le nom de l’armoire dans le fichier .msp au champ Cabinet du nouvel enregistrement ajouté à la table Média. É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. Deux correctifs ne peuvent pas avoir la même propriété source.

Les fichiers partagés au sein de 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 ê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 Fichiers.

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 de i2 à i4, ou de I2 à I4, puis ré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.