Функция UninstallApplication (appmgmt.h)

Статья
03/14/2023

Функция UninstallApplication удаляет приложение групповой политики, которое обрабатывает установку и установку с помощью установщика Windows .msi файлов. Функция UninstallApplication должна вызываться только в контексте пользователя, для которого приложение групповой политики пользователя ранее пыталось удалить, вызвав функцию MsiConfigureProduct . Функция InstallApplication может устанавливать приложения групповой политики.

Примечание Сбой вызова UninstallApplication в рамках протокола для удаления приложения на основе групповой политики может привести к тому, что результирующий набор политик (RSoP) будет указывать неточные сведения.

Синтаксис

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

Параметры

[in] ProductCode

Код продукта установщика Windows для удаляемого продукта. Код продукта приложения должен быть указан в виде GUID установщика Windows в виде строки с фигурными скобками.

[in] dwStatus

Состояние попытки удаления. Параметр dwStatus — это код успеха Windows для попытки удаления, возвращенной MsiConfigureProduct. Система может использовать его, чтобы убедиться, что результирующий набор политик (RSoP) указывает, произошел ли сбой или успешно выполнено удаление.

Возвращаемое значение

Если функция завершается успешно, возвращаемое значение будет ERROR_SUCCESS. В противном случае функция возвращает один из кодов системных ошибок. Полный список кодов ошибок см. в разделе Системные коды ошибок или в файле заголовка WinError.h.

Удалите приложение групповой политики, использующее файлы .msi, вызвав функцию установщика Windows MsiConfigureProduct для удаления приложения. Затем вызовите UninstallApplication, чтобы сообщить системе, что приложение больше не управляется на клиенте с помощью групповая политика. UninstallApplication следует вызывать, даже если удаление завершается сбоем, так как это позволяет системе поддерживать точность результирующих политик (RSoP).

Удалите приложения, установленные с помощью параметров установки программного обеспечения (ZAP-файлы), вызвав функцию удаления или команду, относящуюся к приложению установки. Сведения об использовании приложений установки, отличных от установщика Windows , см. в статье 231747 "Как публиковать программы, не относящиеся к MSI, с zap-файлами" в базе знаний Майкрософт.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	appmgmt.h
Библиотека	Advapi32.lib
DLL	Advapi32.dll

См. также раздел

Функции групповая политика

Обзор групповых политик

InstallApplication

MsiConfigureProduct

Поделиться через