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

Статья
08/22/2023

Функция InstallApplication может устанавливать приложения, развернутые для целевых пользователей, принадлежащих к домену. Контекст безопасности пользователя, вызывающего InstallApplication , должен быть контекстом безопасности пользователя домена, выполнившего вход на компьютер в домене, который доверяет домену целевого пользователя. групповая политика должны быть успешно применены при входе целевого пользователя.

Синтаксис

DWORD InstallApplication(
  [in] PINSTALLDATA pInstallInfo
);

Параметры

[in] pInstallInfo

Указатель на структуру INSTALLDATA , указывающую устанавливаемое приложение.

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

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

Функция InstallApplication может устанавливать только приложения, развернутые с помощью групповая политика. Администратор домена может развертывать приложения для целевых пользователей с помощью раздела конфигурации пользователя групповая политика Objects (GPO). Целевой пользователь должен принадлежать целевому домену, а объект групповой политики должен применяться к этому пользователю в целевом домене. Функция InstallApplication устанавливает приложения в соответствии со стандартными правилами групповая политика наследования. Если одно и то же приложение развертывается в нескольких объектах групповой политики, функция устанавливает версию приложения, развернутую в объекте групповой политики с наивысшим приоритетом. После установки приложения для пользователя оно становится невидимым для других пользователей на компьютере. Это стандартная политика для приложений, развертываемых с помощью групповой политики пользователей.

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

Функция InstallApplication может устанавливать приложения, которые используют для установки пакет установщика Windows . В этом случае пользователь, вызывающий InstallApplication , не должен иметь прав администратора. Система может установить приложение, так как установщик Windows является доверенным приложением, развернутым администратором домена. Пользователь, получающий приложение, должен иметь доступ к расположению файлов .msi.

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

Функция InstallApplication также может устанавливать приложения, использующие приложения установки на основе параметров установки программного обеспечения (ZAP-файлов). Пользователь, получающий приложение, должен иметь доступ к расположению ZAP-файлов. ZAP-файл — это текстовый файл, аналогичный файлу .ini, который позволяет Windows публиковать приложения (например, Setup.exe) для установки с помощью команды "Установка и удаление программ". Чтобы опубликовать приложения, которые не используют установщик Windows, необходимо создать ZAP-файл, скопировать ZAP-файл на серверы точки распространения программного обеспечения, а затем использовать развертывание программного обеспечения на основе групповая политика для публикации приложения для пользователей. Если приложение развертывается с помощью ZAP-файлов, пользователь, устанавливая приложение, должен иметь привилегии на компьютере для установки программного обеспечения. Нельзя использовать ZAP-файлы для назначенных приложений.

Удалите приложения с помощью параметров установки программного обеспечения (ZAP-файлов), вызвав функцию удаления или команду, относящуюся к приложению установки.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	appmgmt.h
Библиотека	Advapi32.lib
DLL	Advapi32.dll
Набор API	ext-ms-win-advapi32-msi-l1-1-0 (представлено в Windows 8)