Properties Table (Patchwiz.dll)
Le tableau propriétés contient des paramètres globaux pour le package de correctifs. La table propriétés 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 Propriétés contient les colonnes suivantes.
Colonne | Type | Clé | Nullable |
---|---|---|---|
Nom | SMS | Y | N |
Valeur | SMS | Y |
Colonnes
-
nom de
-
Nom d’une propriété de création de correctif.
-
valeur
-
Valeur de la propriété de création de correctif.
Remarques
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 de cette propriété est 0. Disponible à partir de Patchwiz.dll version 4.0. |
AllowProductCodeMismatches | Défini sur « 1 » pour True si la propriétéProductCodepeut 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éfini sur « 0 » ou vide pour signifier False si les codes de produit doivent être identiques. |
AllowProductVersionMajorMismatches | Affectez la valeur « 1 » à la valeur True si le premier champ (champ de version principale) de la propriété ProductVersion Peut différer entre les images mises à niveau et les images cibles. Défini sur « 0 » ou vide pour signifier False si les versions principales doivent correspondre. |
ApiPatchingSymbolFlags | Entier hexadécimal à 8 chiffres représentant la combinaison d’indicateurs d’utilisation de 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 PATCH_SYMBOL_* possibles. Pour plus d’informations sur les fichiers de symboles, consultez le glossaire. |
DontRemoveTempFolderWhenFinished | Affectez la valeur « 1 » à la valeur True si le dossier temporaire contenant les transformations, les correctifs au niveau octet 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 de correctifs. Cela peut être utile pour le débogage des correctifs. Défini sur « 0 » ou vide pour signifier False si le dossier temporaire doit être supprimé. |
IncludeWholeFilesOnly | Affectez la valeur « 1 » à la valeur True si les fichiers modifiés 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 la valeur « 0 » ou vide pour signifier False si vous créez un correctif de fichier binaire. |
ListOfPatchGUIDsToReplace | Liste des identificateurs PatchGUID sans délimiteur. Si l’un de ces correctifs est installé sur l’ordinateur de l’utilisateur et inscrit auprès de Windows Installer, il n’est pas inscrit à partir du produit approprié et ses transformations correctives sont supprimées de la liste des transformations associées au produit. Notez que la suppression d’un correctif n’affecte aucun des fichiers, seule l’inscription du correctif. Optionnel. |
ListOfTargetProductCodes | Liste des codes de produit pour les produits susceptibles de recevoir ce correctif. Il s’agit d’une liste délimitée par des points-virgules de Valeurs productCode Property. 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 complet d’un modèle .msi fichier à partir duquel exporter le de la table patch et table PatchPackage. Optional.The Properties Table 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, telle que %ENV_VAR%. N’utilisez pas le type de données de colonne formaté. |
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 supérieurs à environ 4 Mo de taille peuvent être réduits. |
PatchGUID | Identificateur GUID pour ce package de correctifs (fichier .msp). Chaque package de correctifs doit avoir une valeur PatchGUID unique. Obligatoire. |
PatchOutputPath | Chemin d’accès complet, y compris le nom de fichier, du fichier de package de correctifs à générer. Si szPatchPath est passé par la fonction UiCreatePatchPackageEx, la valeur passée est utilisée. Cette propriété est requise si szPatchPath a la valeur Null ou une chaîne vide. 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, telle que %ENV_VAR%. N’utilisez pas le type de données de colonne formaté. |
PatchSourceList | Source utilisée pour localiser le fichier .msp pour le correctif en cas d’indisponibilité de la copie mise en cache locale. Cette valeur est ajoutée à la liste source du correctif lorsqu’il est appliqué à un produit. Optionnel. |
MinimumRequiredMsiVersion | Définissez cette propriété pour forcer Patchwiz.dll à générer un correctif nécessitant une version particulière de Windows Installer. Cette valeur de propriété permet de déterminer la valeur à utiliser pour la Résumé du nombre de mots Propriété du package de correctifs. La valeur de cette propriété est du même formulaire que la Résumé du nombre de pages Propriété du package d’installation. Si un fichier .pcp a une valeur MinimaleRequiredMsiVersion égale à 200, Patchwiz.dll définit la valeur 3 word Count Summary propriété du package de correctifs. 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 MinimaleRequiredMsiVersion égale à 300, Patchwiz.dll définit la valeur 4 Word Count Summary Property of the patch package. Cela empêche l’application du correctif par les versions de Windows Installer antérieures à la version 3.0. Si un fichier .pcp a un minimumRequiredMsiVersion égal à 310, Patchwiz.dll définit la valeur 5 Word Count Summary Property of the patch package. Cela empêche l’application du correctif par Windows Installer antérieure à la version 3.1. Si un fichier .pcp a une valeur MinimaleRequiredMsiVersion égale à 400, Patchwiz.dll définit la propriété Résumé du nombre de mots du package de correctifs 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 correctifs dans le dossier spécifié par la propriété PATCH_CACHE_DIR. La mise en cache des correctifs augmente la vitesse de création de correctifs lors de la recréation d’un nouveau 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 de correctif mis en cache. Patchwiz.dll crée ce dossier si nécessaire. Le dossier doit se trouver sur un lecteur avec suffisamment d’espace disque. Cette propriété est utilisée uniquement si la propriété PATCH_CACHE_ENABLED a la valeur 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, telle que %ENV_VAR%. N’utilisez pas le type de données de colonne formaté. |
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 générées et ajoutées automatiquement. |
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 de 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éé peut 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 de cette propriété est 0. Disponible à partir de Patchwiz.dll version 4.0. |