Partager via


MsiRemovePatchesA, fonction (msi.h)

La fonction MsiRemovePatches supprime un ou plusieurs correctifs d’un seul produit. Pour supprimer un correctif de plusieurs produits, MsiRemovePatches doit être appelé pour chaque produit.

Syntaxe

UINT MsiRemovePatchesA(
  [in]           LPCSTR      szPatchList,
  [in]           LPCSTR      szProductCode,
  [in]           INSTALLTYPE eUninstallType,
  [in, optional] LPCSTR      szPropertyList
);

Paramètres

[in] szPatchList

Chaîne terminée par null qui représente la liste des correctifs à supprimer. Chaque correctif peut être spécifié par le GUID du correctif ou le chemin d’accès complet au package de correctifs. Les correctifs de la liste sont délimités par des points-virgules.

[in] szProductCode

Chaîne terminée par null qui est le ProductCode (GUID) du produit dont les correctifs sont supprimés. Ce paramètre ne peut pas être NULL.

[in] eUninstallType

Valeur qui indique le type de suppression de correctif à effectuer. Ce paramètre doit être INSTALLTYPE_SINGLE_INSTANCE.

Valeur Signification
INSTALLTYPE_SINGLE_INSTANCE
Le correctif est désinstallé uniquement pour le produit spécifié par szProduct.

[in, optional] szPropertyList

Chaîne terminée par null qui spécifie les paramètres de propriété de ligne de commande. Pour plus d’informations, consultez
À propos des propriétés et de la définition des valeurs de propriété publique sur la ligne de commande. Ce paramètre peut être NULL.

Valeur retournée

La fonction MsiRemovePatches retourne les valeurs suivantes.

Valeur Signification
ERROR_INVALID_PARAMETER
Un paramètre non valide a été inclus.
ERROR_PATCH_PACKAGE_OPEN_FAILED
Impossible d’ouvrir le package de correctifs.
ERROR_SUCCESS
Le correctif a été supprimé avec succès.
ERROR_UNKNOWN_PRODUCT
Le produit spécifié par szProductList n’est pas installé par ordinateur ou par utilisateur pour l’appelant de MsiRemovePatches.
ERROR_PATCH_PACKAGE_OPEN_FAILED
Impossible d’ouvrir le package de correctifs.
ERROR_PATCH_PACKAGE_INVALID
Le package de correctif n’est pas valide.
ERROR_PATCH_PACKAGE_UNSUPPORTED
Le package de correctifs ne peut pas être traité par cette version du service Windows Installer.
ERROR_PATCH_REMOVAL_UNSUPPORTED
Le package de correctif n’est pas amovible.
ERROR_UNKNOWN_PATCH
Le correctif n’a pas été appliqué à ce produit.
ERROR_PATCH_REMOVAL_DISALLOWED
La suppression des correctifs a été refusée par la stratégie.

Notes

Consultez Désinstallation de correctifs pour obtenir un exemple qui montre comment une application peut supprimer un correctif de tous les produits disponibles pour l’utilisateur.

Notes

L’en-tête msi.h définit MsiRemovePatches en tant qu’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. La combinaison 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.

Configuration requise

Condition requise Valeur
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

Voir aussi

About Properties

MsiApplyPatch

Installations à plusieurs packages

Non pris en charge par Windows Installer 2.0 et antérieur

ProductCode

Suppression des correctifs

Définition des valeurs de propriété publique sur la ligne de commande

Désinstallation de correctifs