Méthode Installer.ApplyPatch

Pour chaque produit répertorié par le package de correctifs comme pouvant 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 de correctifs.

Syntaxe

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

Paramètres

PatchPackage

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

InstallPackage

Si InstallType est défini sur msiInstallTypeNetworkImage, InstallPackage spécifie le chemin d’accès au produit à corriger. Si InstallType est défini sur msiInstallTypeDefault et InstallPackage est défini sur 0, le programme d’installation applique le correctif à chaque produit éligible répertorié 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 null qui représente le code produit de l’instance à corriger. Ce type d’installation nécessite la version de Windows Installer fournie avec 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 de 1 pour msiInstallTypeNetworkImage spécifie une installation administrative.
msiInstallTypeDefault	Recherche les produits à corriger dans le système. Dans ce cas, InstallPackage doit être une chaîne vide.
msiInstallSingleInstance	Corrige le produit spécifié par InstallPackage. InstallPackage est le code produit de l’instance à corriger. Ce type d’installation nécessite 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 la section Installation de plusieurs instances de produits et de correctifs.

 

CommandLine

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

Valeur retournée

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é REINSTALL est requise lors de l’application d’un correctif de petite mise à jour ou de mise à niveau mineure. 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é REINSTALL sur la ligne de commande lors de l’application d’un correctif de petite mise à jour ou de mise à niveau mineure. Pour les correctifs qui n’utilisent pas de type d’action personnalisée 51 pour définir automatiquement les propriétés REINSTALL et REINSTALLMODE, la propriété REINSTALL doit être définie explicitement avec le paramètre CommandLine. Définissez la propriété REINSTALL pour répertorier les fonctionnalités affectées par le correctif ou utilisez un paramètre pratique par défaut « REINSTALL=ALL ». La valeur par défaut de la propriété REINSTALLMODE est « omus ».

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

Configuration requise

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 comme 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