Properties Table (Patchwiz.dll)

  • Article

La table Propriétés contient des paramètres globaux pour le package correctif. La table Properties est requise dans la base de données de création de correctifs (fichier .pcp) et est utilisée par la fonction UiCreatePatchPackageEx .

La table Properties contient les colonnes suivantes.

Colonne Type Clé Nullable
Nom texte O N
Valeur texte O

 

Colonnes

Nom

Nom d’une propriété de création de correctif.

Valeur

Valeur de la propriété de création de correctif.

Notes

Le tableau suivant identifie les chaînes de propriété de création de correctifs qui peuvent être entrées dans la table Propriétés du fichier .pcp.

Propriété Description
AllowLaxValidationFlags Si cette propriété a la valeur 1, une entrée est écrite dans le journal et aucune erreur n’est retournée si le champ ProductValidateFlags de la table TargetImages ne peut pas être validé. Cette propriété ne doit être définie que lorsque l’auteur du correctif a modifié la valeur dans le champ ProductValidateFlags. La valeur par défaut est 0 pour cette propriété. Disponible à partir de Patchwiz.dll version 4.0.
AllowProductCodeMismatches Définissez la valeur « 1 » pour True si la propriété ProductCode peut différer entre les images mises à niveau répertoriées dans la table UpgradedImages et les images cibles répertoriées dans la table TargetImages. Définissez sur « 0 » ou vide sur False si les codes de produit doivent être identiques.
AllowProductVersionMajorMismatches Définissez sur « 1 » pour signifier True si le premier champ (le champ de version principale) de la propriété ProductVersion peut différer entre les images mises à niveau et les images cibles. Définissez sur « 0 » ou vide sur False si les versions principales doivent correspondre.
ApiPatchingSymbolFlags Un entier hexadécimal à 8 chiffres représentant la combinaison d’indicateurs d’utilisation des symboles de correctif à utiliser lors de la création d’un correctif de fichier binaire. La valeur par défaut est 0x00000000. Consultez Patchapi.h pour obtenir la liste complète des indicateurs de PATCH_SYMBOL_* possibles. Pour plus d’informations sur les fichiers de symboles, consultez le glossaire.
DontRemoveTempFolderWhenFinished Définissez sur « 1 » pour signifier True si le dossier temporaire contenant les transformations, les correctifs au niveau des octets et les nouveaux fichiers entiers ne sont pas supprimés après la création du package de correctifs. Il s’agit essentiellement du contenu du fichier .msp avant d’être incorporé dans le package correctif. Cela peut être utile pour le débogage de correctifs. Définissez sur « 0 » ou vide pour avoir la valeur False si le dossier temporaire doit être supprimé.
IncludeWholeFilesOnly Définissez la valeur « 1 » pour avoir la valeur True si les fichiers en cours de modification doivent être inclus dans leur intégralité lors de la création du package de correctifs au lieu de créer un correctif de fichier binaire. Les fichiers correctifs seront plus volumineux, mais l’API s’exécute plus rapidement. Définissez sur « 0 » ou vide pour avoir la valeur False si vous créez un correctif de fichier binaire.
ListOfPatchGUIDsToReplace Liste d’identificateurs PatchGUID sans délimiteur. Si l'un de ces correctifs est installé sur l'ordinateur de l'utilisateur et enregistré avec Windows Installer, il est Désinscrit du produit approprié et ses transformations de correctifs sont supprimées de la liste des transformations associées au produit. Notez que la suppression d’un correctif n’affecte aucun des fichiers, mais uniquement l’inscription du correctif. facultatif.
ListOfTargetProductCodes Liste des codes de produit pour les produits qui peuvent recevoir ce correctif. Il s’agit d’une liste délimitée par des points-virgules de valeurs de propriété ProductCode . Si la liste commence par un astérisque, la liste des codes de produit est générée à partir des fichiers .msi des cibles répertoriées dans la table TargetImages. Si des codes de produit suivent un astérisque de début, ils sont ajoutés à la liste qui remplace l’astérisque. Si la propriété n’est pas définie, une liste de codes de produit est générée à partir des fichiers .msi des cibles répertoriées dans la table TargetImages.
MsiFileToUseToCreatePatchTables Chemin d’accès complet à un modèle de fichier .msi à partir duquel seront exportées la Table patch et la table PatchPackage. Facultatif.La table Propriétés accepte les variables d’environnement pour les chemins d’accès à partir de la version 4.0 de Patchwiz.dll. Utilisez le format Windows pour la variable d’environnement, par exemple %ENV_VAR %. Ne pas utiliser le type de données Formatted pour la colonne.
OptimizePatchSizeForLargeFiles Cette propriété est définie lorsque la valeur existe et n’est pas « 0 ». Lorsque cette propriété est définie, les correctifs pour les fichiers d’une taille supérieure à environ 4 Mo peuvent être réduits.
PatchGUID Identificateur GUID pour ce package de correctif (fichier .msp). Chaque package de correctifs doit avoir une valeur PatchGUID unique. Obligatoire.
PatchOutputPath Le Chemin d’accès complet, y compris le nom de fichier, du fichier de package correctif qui doit être généré. Si szPatchPath est transmise par la fonction UiCreatePatchPackageEx , la valeur transmise est utilisée. Cette propriété est requise si szPatchPath a la valeur null ou une chaîne vide. La table de Propriétés accepte les variables d’environnement pour les chemins d’accès à partir de la version 4.0 de Patchwiz.dll. Utilisez le format Windows pour la variable d’environnement, par exemple %ENV_VAR %. Ne pas utiliser le type de données Formatted pour la colonne.
PatchSourceList Source utilisée pour localiser le fichier .msp pour le correctif dans le cas où la copie mise en cache localement n’est pas disponible. Cette valeur est ajoutée à la liste des sources du correctif lorsqu’il est appliqué à un produit. facultatif.
MinimumRequiredMsiVersion Définissez cette propriété pour forcer Patchwiz.dll à générer un correctif qui nécessite une version particulière de Windows Installer. Cette valeur de propriété permet de déterminer la valeur à utiliser pour la propriété Word Count Summary du package de correctifs. La valeur de cette propriété est de la même forme que la propriété Page Count Summarydu package d’installation. Si un fichier .pcp a une valeur MinimumRequiredMsiVersion égale à 200, Patchwiz.dll définit la propriété Word Count Summary du package correctif sur 3. Cela empêche l’application du correctif par la version de Windows Installer antérieure à la version 2.0.
Si un fichier .pcp a une valeur MinimumRequiredMsiVersion égale à 300, Patchwiz.dll définit la propriété Word Count Summary du package correctif sur 4. Cela empêche l’application du correctif par les versions de Windows Installer antérieures à la version 3.0.
Si un fichier .pcp a une valeur MinimumRequiredMsiVersion égale à 310, Patchwiz.dll définit la propriété Word Count Summary du package correctif sur 5. Cela empêche l’application du correctif par Windows Installer antérieure à la version 3.1.
Si un fichier .pcp a une valeur MinimumRequiredMsiVersion égale à 400, Patchwiz.dll définit la propriété Word Count Summary du package correctif sur 6. Cela empêche l’application du correctif par Windows Installer antérieure à la version 4.0.
PATCH_CACHE_ENABLED Définissez cette propriété sur 1 pour mettre en cache les informations de création de correctif dans le dossier spécifié par la propriété PATCH_CACHE_DIR. La mise en cache corrective augmente la vitesse de création de correctifs lors de la recréation d’un correctif après la mise à jour de l’image de mise à jour. Cette propriété nécessite Patchwiz.dll dans Windows Installer 2.0 ou version ultérieure. Pour plus d’informations, consultez Mise en cache des informations correctives (Patchwiz.dll).
PATCH_CACHE_DIR Définissez cette propriété sur le nom du dossier qui stocke les informations sur le correctif de mis en cache. Patchwiz.dll crée ce dossier si nécessaire. Le dossier doit se trouver sur un lecteur disposant d’un espace disque suffisant. Cette propriété n'est utilisée que si la propriété PATCH_CACHE_ENABLED est définie sur 1. La table Propriétés accepte les variables d’environnement pour les chemins d’accès commençant par la version 4.0 de Patchwiz.dll. Utilisez le format Windows pour la variable d’environnement, par exemple %ENV_VAR %. Ne pas utiliser le type de données Formatted pour la colonne.
SEQUENCE_DATA_GENERATION_DISABLED Définissez cette propriété sur 1 (un) pour empêcher la génération automatique d’informations de séquencement de correctifs. Si cette propriété est absente, les informations de séquencement sont automatiquement générées et ajoutées.
SEQUENCE_DATA_SUPERSEDENCE Définissez cette propriété sur 0 (zéro) ou 1 (un) pour écrire cette valeur dans le champ Attributs de toutes les lignes de la table MsiPatchSequence.
TrustMsi Définissez cette propriété sur 1 dans la table Propriétés pour utiliser les informations de version du fichier, la taille et les valeurs de hachage fournies dans le fichier .msi. Si cette propriété est définie mais que les informations contenues dans le fichier .msi sont incorrectes, le correctif créé risque de ne pas fonctionner correctement. Vous devez mettre à jour les fichiers .msi cibles et mis à niveau à l’aide de MsiFiler.exe. La valeur par défaut est 0 pour cette propriété. Disponible à partir de Patchwiz.dll version 4.0.