UninstallApplication-Funktion (appmgmt.h)
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.
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-FunktionMsiConfigureProduct 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 |