MsiApplyMultiplePatchesW, fonction (msi.h)

Article
08/24/2023

La fonction MsiApplyMultiplePatches applique un ou plusieurs correctifs aux produits éligibles pour recevoir les correctifs. La fonction MsiApplyMultiplePatches définit la propriété PATCH avec une liste de correctifs délimités par des points-virgules et appelle la mise à jour corrective des produits cibles. D’autres propriétés peuvent être définies à l’aide d’une liste de propriétés.

Syntaxe

UINT MsiApplyMultiplePatchesW(
  [in]           LPCWSTR szPatchPackages,
  [in, optional] LPCWSTR szProductCode,
  [in, optional] LPCWSTR szPropertiesList
);

Paramètres

[in] szPatchPackages

Liste délimitée par des points-virgules des chemins d’accès aux fichiers correctifs sous forme d’une chaîne unique. Par exemple : « "c:\sus\download\cache\Office\sp1.msp; c:\sus\download\cache\Office\QFE1.msp; c:\sus\download\cache\Office\QFEn.msp » »

[in, optional] szProductCode

Ce paramètre est le GUID ProductCode du produit à corriger. L’utilisateur ou l’application qui appelle MsiApplyMultiplePatches doit disposer de privilèges pour appliquer des correctifs. Lorsque ce paramètre a la valeur NULL, les correctifs sont appliqués à tous les produits éligibles. Lorsque ce paramètre n’a pas la valeur NULL, les correctifs sont appliqués uniquement au produit spécifié.

[in, optional] szPropertiesList

Chaîne terminée par null qui spécifie les paramètres de propriété de ligne de commande utilisés lors de la mise à jour corrective des produits. S’il n’existe aucun paramètre de propriété de ligne de commande, transmettez un pointeur NULL . Une chaîne vide est un paramètre non valide. Ces propriétés sont partagées par tous les produits cibles. Pour plus d'informations, consultez la rubrique
À propos des propriétés et de la définition des valeurs de propriété publique sur la ligne de commande.

Note La liste des propriétés ne doit pas contenir la propriété PATCH . Si la propriété PATCH est définie dans la ligne de commande, la valeur est ignorée et est remplacée par les correctifs appliqués.

Valeur retournée

La fonction MsiApplyMultiplePatches retourne les valeurs suivantes.

Valeur	Signification
ERROR_INVALID_PARAMETER	Certains arguments transmis sont incorrects ou contredisants.
ERROR_SUCCESS	La fonction s’est terminée et tous les produits sont correctement corrigés. ERROR_SUCCESS est retourné uniquement si tous les produits éligibles pour les correctifs ont été correctement corrigés. Si aucun des nouveaux correctifs n’est applicable, MsiApplyMultiplePatches retourne ERROR_SUCCESS et l’état du produit reste inchangé.
ERROR_SUCCESS_REBOOT_INITIATED	Le redémarrage initié par la dernière transaction a mis fin à cet appel à MsiApplyMultiplePatches. Tous les produits cibles n’ont peut-être pas été corrigés.
ERROR_SUCCESS_REBOOT_REQUIRED	Le redémarrage requis par la dernière transaction a mis fin à cet appel à MsiApplyMultiplePatches. Tous les produits cibles n’ont peut-être pas été corrigés.
ERROR_PATCH_PACKAGE_OPEN_FAILED	L’un des packages correctifs fournis n’a pas pu être ouvert.
ERROR_PATCH_PACKAGE_INVALID	L’un des packages correctifs fournis n’est pas valide.
ERROR_PATCH_PACKAGE_UNSUPPORTED	L’un des packages correctifs n’est pas pris en charge.
Toute erreur dans Winerror.h	Implique une exécution partielle possible ou l’échec d’une ou plusieurs transactions.

Notes

L’en-tête msi.h définit MsiApplyMultiplePatches comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Spécifications


Client minimal pris en charge	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. Pour plus d’informations sur le Service Pack Windows requis par une version de Windows Installer, consultez Configuration requise pour le runtime Windows.
Plateforme cible	Windows
En-tête	msi.h
Bibliothèque	Msi.lib
DLL	Msi.dll