UninstallApplication-Funktion (appmgmt.h)

Artikel
08/22/2023

Die UninstallApplication-Funktion deinstalliert eine Gruppenrichtlinienanwendung, die das Setup und die Installation mithilfe von Windows Installer .msi Dateien übernimmt. Die UninstallApplication-Funktion sollte nur im Kontext des Benutzers aufgerufen werden, für den die Benutzergruppenrichtlinienanwendung zuvor eine Deinstallation durch Aufrufen der MsiConfigureProduct-Funktion versucht hat. Die InstallApplication-Funktion kann Gruppenrichtlinienanwendungen installieren.

Hinweis Fehler beim Aufrufen von UninstallApplication als Teil des Protokolls zum Deinstallieren einer gruppenrichtlinienbasierten Anwendung kann dazu führen, dass der Resultant Set of Policy (RSoP) ungenaue Informationen angibt.

Syntax

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

Parameter

[in] ProductCode

Der Windows Installer-Produktcode des zu deinstallierenden Produkts. Der Produktcode der Anwendung sollte in Form einer Windows Installer-GUID als Zeichenfolge mit Klammern bereitgestellt werden.

[in] dwStatus

Der status des Deinstallationsversuchs. Der dwStatus-Parameter ist der Windows-Erfolgscode des von MsiConfigureProduct zurückgegebenen Deinstallationsversuchs. Das System kann dies verwenden, um sicherzustellen, dass der Resultierende Richtliniensatz (Resultant Set of Policy, RSoP) angibt, ob die Deinstallation fehlgeschlagen oder erfolgreich war.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS. Andernfalls gibt die Funktion einen der Systemfehlercodes zurück. Eine vollständige Liste der Fehlercodes finden Sie unter Systemfehlercodes oder in der Headerdatei WinError.h.

Hinweise

Entfernen Sie eine Gruppenrichtlinienanwendung, die .msi Dateien verwendet, indem Sie die Windows Installer-Funktion MsiConfigureProduct aufrufen, um die Anwendung zu deinstallieren. Rufen Sie dann UninstallApplication auf, um das System darüber zu informieren, dass die Anwendung nicht mehr auf dem Client von Gruppenrichtlinie verwaltet wird. UninstallApplication sollte auch dann aufgerufen werden, wenn die Deinstallation fehlschlägt, da das System dadurch die Genauigkeit des resultierenden Richtliniensatzes (Resultant Set of Policy, RSoP) beibehalten kann.

Entfernen Sie anwendungen, die mithilfe von Softwareinstallationseinstellungen (.zap-Dateien) installiert werden, indem Sie die Deinstallationsfunktion oder den für die Installationsanwendung spezifischen Befehl aufrufen. Informationen zur Verwendung anderer Installationsanwendungen als windows Installer finden Sie in der Microsoft Knowledge Base im Artikel 231747, "Veröffentlichen von Nicht-MSI-Programmen mit ZAP-Dateien".

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	appmgmt.h
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Weitere Informationen

Gruppenrichtlinie-Funktionen

Übersicht über Gruppenrichtlinien

InstallApplication

MsiConfigureProduct

Freigeben über