Table TargetImages (Patchwiz.dll)

La table TargetImages contient des informations sur les images cibles du produit. Un package de correctifs Windows Installer met à jour une image cible dans une image mise à niveau.

Une table TargetImages 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 UiCreatePatchPackage .

La table TargetImages comporte les colonnes suivantes.

Colonne Type Clé Nullable
Cible texte O N
MsiPath texte   N
SymbolPaths texte   O
Upgraded texte   N
JSON entier   N
ProductValidateFlags texte   O
IgnoreMissingSrcFiles entier   N

 

Colonnes

Cible

Identificateur d’une image cible. Le package de correctifs met à jour l’image cible spécifiée dans cette colonne vers l’image mise à niveau spécifiée dans la colonne Mise à niveau. Il existe une ou plusieurs images cibles pour chaque image mise à niveau. L’image cible doit être une image d’installation entièrement non compressée du produit, telle qu’une image administrative ou une image de configuration non compressée sur un CD-ROM. Notez que la fonction UiCreatePatchPackageEx ne génère pas de correctifs binaires pour les fichiers dans les armoires. La valeur de ce champ est utilisée avec la valeur du champ Mise à niveau pour générer les noms des transformations que le programme d’installation ajoute au package de correctifs.

MsiPath

Ce champ spécifie le chemin d’accès complet, y compris le nom de fichier, à l’emplacement du fichier .msi pour l’image cible. Il s’agit de l’emplacement des fichiers sources de l’image cible.

SymbolPaths

Liste délimitée par des points-virgules de dossiers qui doivent faire l’objet d’une recherche pour rechercher des fichiers de symboles pouvant être utilisés pour optimiser la génération du correctif binaire. Notez que les sous-répertoires des dossiers spécifiés dans ce champ ne font pas l’objet d’une recherche. Un correctif binaire optimisé peut être plus petit. Microsoft Visual C++ doit être installé sur l’ordinateur qui génère le correctif et utilisé pour créer les fichiers de symboles. Ce champ est facultatif, et le programme d’installation crée un correctif binaire même si aucun fichier de symboles n’est spécifié ou si les fichiers de symboles deviennent indisponibles pour Patchwiz.dll.

Mis à niveau

Clé étrangère de la colonne Mise à niveau de la table UpgradedImages. La fonction UiCreatePatchPackageEx ignore toute image mise à niveau qui n’est pas référencée par au moins un enregistrement de la table TargetImages.

Ordre

Ordre relatif de l’image cible. Étant donné que plusieurs cibles peuvent être corrigées sur une image mise à niveau, le champ Ordre fournit un moyen de séquencer les transformations dans la liste des transformations correctives. En règle générale, l’ordre est de l’image la plus ancienne à la plus récente.

ProductValidateFlags

Le champ ProductValidateFlags est utilisé pour spécifier la vérification des produits afin d’éviter d’appliquer des transformations non pertinentes. La valeur entrée dans ce champ doit être un entier hexadécimal à 8 chiffres et l’une des valeurs valides pour le paramètre iValidation de la fonction MsiCreateTransformSummaryInfo. La valeur par défaut est 0x00000922 qui est égale MSITRANSFORM_VALIDATE_UPDATEVERSION + MSITRANSFORM_VALIDATE_NEWEQUALBASEVERSION + MSITRANSFORM_VALIDATE_UPGRADECODE + MSITRANSFORM_VALIDATE_PRODUCT.

IgnoreMissingSrcFiles

Si ce champ est défini sur une valeur différente de zéro, les fichiers manquants dans l’image cible sont ignorés par le programme d’installation et laissés inchangés pendant la mise à jour corrective. Cela permet d’effectuer des correctifs sans nécessiter la totalité de l’image ; seuls les fichiers modifiés du produit et le fichier .msi sont requis. Cela peut réduire le temps nécessaire pour générer le correctif.

Notes

N’utilisez pas la valeur IgnoreMissingSrcFiles avec TrustMsi définie sur 1 dans la table Properties.

 

Notes

Cette table accepte les variables d’environnement comme chemins d’accès à partir de la version 4.0 de Patchwiz.dll.