UninstallApplication, fonction (appmgmt.h)

Article
03/01/2024

La fonction UninstallApplication désinstalle une application de stratégie de groupe qui gère l’installation et l’installation à l’aide de fichiers .msi Windows Installer . La fonction UninstallApplication doit uniquement être appelée dans le contexte de l’utilisateur pour lequel l’application de stratégie de groupe d’utilisateurs a précédemment tenté de désinstaller en appelant la fonction MsiConfigureProduct . La fonction InstallApplication peut installer des applications de stratégie de groupe.

Note Si vous n’appelez pas UninstallApplication dans le cadre du protocole de désinstallation d’une application basée sur une stratégie de groupe, le jeu de stratégies résultant (RSoP) indique des informations inexactes.

Syntaxe

DWORD UninstallApplication(
  [in] LPWSTR ProductCode,
  [in] DWORD  dwStatus
);

Paramètres

[in] ProductCode

Code de produit Windows Installer du produit en cours de désinstallation. Le code produit de l’application doit être fourni sous la forme d’un GUID Windows Installer sous la forme d’une chaîne avec accolades.

[in] dwStatus

Status de la tentative de désinstallation. Le paramètre dwStatus est le code de réussite Windows de la tentative de désinstallation retournée par MsiConfigureProduct. Le système peut l’utiliser pour s’assurer que le jeu de stratégie résultant ( RSoP) indique si la désinstallation a échoué ou réussi.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS. Sinon, la fonction retourne l’un des codes d’erreur système. Pour obtenir la liste complète des codes d’erreur, consultez Codes d’erreur système ou le fichier d’en-tête WinError.h.

Remarques

Supprimez une application de stratégie de groupe qui utilise .msi fichiers en appelant la fonction Windows Installer MsiConfigureProduct pour désinstaller l’application. Appelez ensuite UninstallApplication pour informer le système que l’application n’est plus gérée sur le client par stratégie de groupe. UninstallApplication doit être appelé même si la désinstallation échoue, car cela permet au système de conserver l’ensemble de stratégie résultant (RSoP) exact.

Supprimez les applications installées à l’aide des paramètres d’installation de logiciels (fichiers .zap) en appelant la fonction de désinstallation ou la commande spécifique de l’application d’installation. Pour plus d’informations sur l’utilisation d’applications d’installation autres que Windows Installer , consultez l’article 231747, « Comment publier des programmes non MSI avec des fichiers .zap » dans la Base de connaissances Microsoft.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	appmgmt.h
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll

Voir aussi

fonctions stratégie de groupe

Vue d’ensemble de la stratégie de groupe

InstallApplication

MsiConfigureProduct

Partager via