Installer. ApplyPatch, méthode

Pour chaque produit indiqué par le package de correctifs comme éligibles pour recevoir le correctif, la méthode ApplyPatch de l’objet installer appelle une installation et définit la propriété patch sur le chemin d’accès du package correctif.

Syntaxe

Installer.ApplyPatch(
  PatchPackage,
  InstallPackage,
  InstallType,
  CommandLine
)

Paramètres

PatchPackage

Spécifie un chemin d’accès au package de correctifs.

InstallPackage

Si InstallType a la valeur MsiInstallTypeNetworkImage, INSTALLPACKAGE spécifie le chemin d’accès au produit qui doit être corrigé. Si InstallType a la valeur msiInstallTypeDefault et que INSTALLPACKAGE a la valeur 0, le programme d’installation applique le correctif à tous les produits éligibles figurant dans le package de correctifs.

Si InstallType est msiInstallTypeSingleInstance, le programme d’installation applique le correctif au produit spécifié par INSTALLPACKAGE. Dans ce cas, les autres produits éligibles répertoriés dans le package de correctifs sont ignorés et le paramètre INSTALLPACKAGE contient la chaîne terminée par le caractère null qui représente le code de produit de l’instance à corriger. ce type d’installation requiert la version de Windows Installer fournie avec le Windows Server 2003 ou version ultérieure, ou Windows Installer XP SP1 ou version ultérieure.

InstallType (type d'installation)

Ce paramètre spécifie le type d’installation à corriger. Le paramètre InstallType est ignoré si INSTALLPACKAGE est omis.

Valeur Signification
msiInstallTypeNetworkImage
Indique une installation administrative. Dans ce cas, INSTALLPACKAGE doit être défini sur un chemin d’accès de package. La valeur 1 pour msiInstallTypeNetworkImage spécifie une installation d’administration.
msiInstallTypeDefault
Recherche des produits à corriger dans le système. Dans ce cas, INSTALLPACKAGE doit être une chaîne vide.
msiInstallSingleInstance
Correction du produit spécifié par INSTALLPACKAGE. INSTALLPACKAGE est le code du produit de l’instance à corriger. ce type d’installation requiert la version de Windows Installer fournie avec Windows Server 2003 ou version ultérieure, ou Windows Installer XP SP1 ou version ultérieure. Pour plus d’informations, consultez installation de plusieurs instances de produits et correctifs.

CommandLine

Spécifie les paramètres de propriété définis sur la ligne de commande. Consultez la section Notes.

Valeur de retour

Cette méthode ne retourne pas de valeur.

Notes

Étant donné que le délimiteur de liste pour les transformations, les sources et les correctifs est un point-virgule, ce caractère ne doit pas être utilisé pour les noms de fichiers ou les chemins d’accès.

La propriété de réinstallation est requise lors de l’application d’une petite mise à jour ou d’un correctif de mise à niveau mineur . Sans cette propriété, le correctif est inscrit sur le système, mais ne peut pas mettre à jour les fichiers.

Windows Installer 2,0 : Vous devez définir la propriété réinstaller sur la ligne de commande lors de l’application d’une petite mise à jour ou d’un correctif de mise à niveau mineure . Pour les correctifs qui n’utilisent pas de type d’action personnalisé 51 pour définir automatiquement les propriétés REINSTALL et REINSTALLMODE , la propriété REINSTALL doit être définie explicitement à l’aide du paramètre CommandLine . Définissez la propriété réinstaller pour répertorier les fonctionnalités affectées par le correctif ou utilisez un paramètre par défaut pratique « réinstaller = All ». La valeur par défaut de la propriété REINSTALLMODE est « omus ».

Windows Installer 3,0 et versions ultérieures : à partir de Windows Installer version 3,0, la propriété de réinstallation est configurée par le programme d’installation et n’a pas besoin d’être définie sur la ligne de commande.

Spécifications

Condition requise Valeur
Version
Windows Installer 5,0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4,0 ou Windows Installer 4,5 sur Windows Server 2008 ou Windows Vista. Windows Installer 3,0 ou version ultérieure sur Windows Server 2003 ou Windows XP.
DLL
Msi.dll
IID
IID _ IInstaller est défini en tant que 000C1090-0000-0000-C000-000000000046

Voir aussi

MsiApplyPatch

À propos des propriétés

non pris en charge dans Windows Installer 2,0 et versions antérieures