AppInstallManager Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет участникам программную установку приложений, включая возможность запуска установки приложения и получения списка установленных в настоящее время приложений.
public ref class AppInstallManager sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class AppInstallManager final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class AppInstallManager final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class AppInstallManager
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class AppInstallManager
function AppInstallManager()
Public NotInheritable Class AppInstallManager
- Наследование
- Атрибуты
Требования к Windows
| Требования | Описание |
|---|---|
| Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
| Возможности приложения |
runFullTrust
|
Комментарии
Это важно
Доступ к этому API защищен частными возможностями, которые ограничены приложениями, разработанными Майкрософт.
Замечание
Избегайте вызова AppInstallManager.StartProductInstallAsync или AppInstallManager.StartProductInstallForUserAsync во время Windows интерфейсе out of Box (OOBE).
Запросы на установку, сделанные до завершения OOBE, могут не вести себя должным образом, так как службы, связанные с Магазином, еще не могут быть полностью инициализированы.
Для получения наилучших результатов вызовите эти методы после первого входа пользователя.
История версий
| версия Windows | Версия пакета SDK | Добавлено значение |
|---|---|---|
| 1511 | 10586 | Cancel(String,String) |
| 1511 | 10586 | GetIsAppAllowedToInstallAsync(String,String,String,String,String) |
| 1511 | 10586 | Pause(String,String) |
| 1511 | 10586 | Restart(String,String) |
| 1511 | 10586 | SearchForAllUpdatesAsync(String) |
| 1511 | 10586 | SearchForUpdatesAsync(String,String,String,String,String) |
| 1511 | 10586 | StartAppInstallAsync(String,String,Boolean,Boolean,String,String,String) |
| 1511 | 10586 | UpdateAppByPackageFamilyNameAsync(String,String) |
| 1607 | 14393 | GetIsAppAllowedToInstallForUserAsync |
| 1607 | 14393 | GetIsApplicableForUserAsync |
| 1607 | 14393 | MoveToFrontOfDownloadQueue |
| 1607 | 14393 | SearchForAllUpdatesForUserAsync(User,String) |
| 1607 | 14393 | SearchForUpdatesForUserAsync(User,String,String,String,String) |
| 1607 | 14393 | StartProductInstallAsync(String,String,String,String,Boolean,Boolean,String,PackageVolume) |
| 1607 | 14393 | StartProductInstallForUserAsync(User,String,String,String,String,Boolean,Boolean,String,PackageVolume) |
| 1607 | 14393 | UpdateAppByPackageFamilyNameForUserAsync |
| 1703 | 15063 | AppInstallItemsWithGroupSupport |
| 1703 | 15063 | GetFreeDeviceEntitlementAsync |
| 1703 | 15063 | GetFreeUserEntitlementAsync |
| 1703 | 15063 | GetFreeUserEntitlementForUserAsync |
| 1803 | 17134 | GetIsPackageIdentityAllowedToInstallAsync |
| 1803 | 17134 | GetIsPackageIdentityAllowedToInstallForUserAsync |
| 1803 | 17134 | SearchForAllUpdatesAsync(String,String,AppUpdateOptions) |
| 1803 | 17134 | SearchForAllUpdatesForUserAsync(User,String,String,AppUpdateOptions) |
| 1803 | 17134 | SearchForUpdatesAsync(String,String,String,String,String,AppUpdateOptions) |
| 1803 | 17134 | SearchForUpdatesForUserAsync(User,String,String,String,String,String,AppUpdateOptions) |
| 1803 | 17134 | StartProductInstallAsync(String,String,String,String,String,AppInstallOptions) |
| 1803 | 17134 | StartProductInstallForUserAsync(User,String,String,String,String,String,AppInstallOptions) |
| 1809 | 17763 | CanInstallForAllUsers |
Конструкторы
| Имя | Описание |
|---|---|
| AppInstallManager() |
Создает и инициализирует новый экземпляр класса AppInstallManager . |
Свойства
| Имя | Описание |
|---|---|
| AcquisitionIdentity |
Возвращает или задает удостоверение пользователя, связанное с установкой приложения. |
| AppInstallItems |
Извлекает сведения обо всех приложениях, которые в настоящее время находятся в очереди установки. |
| AppInstallItemsWithGroupSupport |
Извлекает сведения обо всех приложениях, которые являются частью одного пакета приложений, который в настоящее время находится в очереди установки. |
| AutoUpdateSetting |
Возвращает или задает параметр автоматического обновления для приложений на текущем компьютере или устройстве. |
| CanInstallForAllUsers |
Возвращает или задает значение, указывающее, имеет ли вызывающее приложение повышенные права администратора, чтобы обеспечить успешное установку приложения для всех пользователей. |
Методы
| Имя | Описание |
|---|---|
| Cancel(String, String) |
Отменяет установку указанного приложения с возможностью создания данных телеметрии. |
| Cancel(String) |
Отменяет установку указанного приложения. |
| GetFreeDeviceEntitlementAsync(String, String, String) |
Предоставляет бесплатное право для указанного приложения всем пользователям на текущем устройстве. |
| GetFreeUserEntitlementAsync(String, String, String) |
Предоставляет бесплатное право для указанного приложения текущему пользователю. |
| GetFreeUserEntitlementForUserAsync(User, String, String, String) |
Предоставляет пользователю бесплатное право на доступ к указанному приложению. |
| GetIsAppAllowedToInstallAsync(String, String, String, String) |
Определяет, имеет ли указанное приложение разрешение на установку на текущем компьютере или устройстве с возможностью создания данных телеметрии. |
| GetIsAppAllowedToInstallAsync(String) |
Определяет, имеет ли указанное приложение разрешение на установку на текущем компьютере или устройстве. |
| GetIsAppAllowedToInstallForUserAsync(User, String, String, String, String) |
Определяет, имеет ли указанное приложение разрешение на установку на текущем компьютере или устройстве для указанного пользователя с возможностью создания данных телеметрии. |
| GetIsApplicableAsync(String, String) |
Определяет, можно ли установить указанное приложение на текущем компьютере или устройстве. |
| GetIsApplicableForUserAsync(User, String, String) |
Определяет, можно ли установить указанное приложение на текущем компьютере или устройстве для указанного пользователя. |
| GetIsPackageIdentityAllowedToInstallAsync(String, String, String) |
Возвращает значение, указывающее, разрешено ли установить пакет с указанными сведениями удостоверения на текущем устройстве. |
| GetIsPackageIdentityAllowedToInstallForUserAsync(User, String, String, String) |
Возвращает значение, указывающее, разрешено ли установить пакет с указанными сведениями удостоверения на текущем устройстве для указанного пользователя. |
| IsStoreBlockedByPolicyAsync(String, String) |
Определяет, блокируется ли указанное приложение политикой на текущем компьютере или устройстве. |
| MoveToFrontOfDownloadQueue(String, String) |
Перемещает указанное приложение в передней части очереди скачивания. |
| Pause(String, String) |
Приостанавливает установку указанного приложения с возможностью создания данных телеметрии. |
| Pause(String) |
Приостанавливает установку указанного приложения. |
| Restart(String, String) |
Перезапускает установку указанного приложения с возможностью создания данных телеметрии. |
| Restart(String) |
Перезапускает установку указанного приложения. |
| SearchForAllUpdatesAsync() |
Выполняет поиск всех доступных обновлений приложений, установленных на текущем компьютере или устройстве. |
| SearchForAllUpdatesAsync(String, String, AppUpdateOptions) |
Выполняет поиск всех доступных обновлений приложений, установленных на текущем компьютере или устройстве, с возможностью принудительного перезапуска приложения и возможностью создания данных телеметрии. |
| SearchForAllUpdatesAsync(String) |
Выполняет поиск всех доступных обновлений приложений, установленных на текущем компьютере или устройстве, с возможностью создания данных телеметрии. |
| SearchForAllUpdatesForUserAsync(User, String, String, AppUpdateOptions) |
Выполняет поиск всех доступных обновлений приложений, установленных на текущем компьютере или устройстве для указанного пользователя, с возможностью принудительного перезапуска приложения и возможностью создания данных телеметрии. |
| SearchForAllUpdatesForUserAsync(User, String) |
Выполняет поиск всех доступных обновлений приложений, установленных на текущем компьютере или устройстве для указанного пользователя, с возможностью создания данных телеметрии. |
| SearchForUpdatesAsync(String, String, String, String, AppUpdateOptions) |
Выполняет поиск обновлений для указанного приложения с возможностью принудительного перезапуска приложения и возможностью создания данных телеметрии. |
| SearchForUpdatesAsync(String, String, String, String) |
Выполняет поиск обновлений для указанного приложения с возможностью создания данных телеметрии. |
| SearchForUpdatesAsync(String, String) |
Выполняет поиск обновлений для указанного приложения. |
| SearchForUpdatesForUserAsync(User, String, String, String, String, AppUpdateOptions) |
Выполняет поиск обновлений для указанного приложения и пользователя с возможностью принудительного перезапуска приложения и возможности создания данных телеметрии. |
| SearchForUpdatesForUserAsync(User, String, String, String, String) |
Выполняет поиск обновлений для указанного приложения и пользователя с возможностью создания данных телеметрии. |
| StartAppInstallAsync(String, String, Boolean, Boolean, String, String, String) |
Замечание Обратите внимание, что Запускает установку указанного приложения с возможностью создания данных телеметрии. |
| StartAppInstallAsync(String, String, Boolean, Boolean) |
Замечание Обратите внимание, что Запускает установку указанного приложения. |
| StartProductInstallAsync(String, String, String, String, AppInstallOptions) |
Запускает установку указанного пакета приложений или приложений с возможностью указания дополнительных параметров установки, таких как разрешение принудительного перезапуска приложения. Замечание Избегайте вызова Запросы на установку, сделанные до завершения OOBE, могут не вести себя должным образом, так как службы, связанные с Магазином, еще не могут быть полностью инициализированы. Для получения наилучших результатов вызовите эти методы после первого входа пользователя. |
| StartProductInstallAsync(String, String, String, String, Boolean, Boolean, String, PackageVolume) |
Запускает установку указанного пакета приложений или приложений. |
| StartProductInstallForUserAsync(User, String, String, String, String, AppInstallOptions) |
Запускает установку указанного приложения или пакета приложений для указанного пользователя с возможностью указания дополнительных параметров установки, таких как разрешение принудительного перезапуска приложения. Замечание Избегайте вызова Запросы на установку, сделанные до завершения OOBE, могут не вести себя должным образом, так как службы, связанные с Магазином, еще не могут быть полностью инициализированы. Для получения наилучших результатов вызовите эти методы после первого входа пользователя. |
| StartProductInstallForUserAsync(User, String, String, String, String, Boolean, Boolean, String, PackageVolume) |
Запускает установку указанного приложения или пакета приложений для указанного пользователя. |
| UpdateAppByPackageFamilyNameAsync(String, String) |
Запускает обновление приложения, указанного именем семейства пакетов, с возможностью создания данных телеметрии. |
| UpdateAppByPackageFamilyNameAsync(String) |
Запускает обновление приложения, указанного именем семейства пакетов. |
| UpdateAppByPackageFamilyNameForUserAsync(User, String, String) |
Запускает обновление приложения для данного пользователя, указанного именем семейства пакетов, с возможностью создания данных телеметрии. |
События
| Имя | Описание |
|---|---|
| ItemCompleted |
Происходит, когда приложение завершит установку. |
| ItemStatusChanged |
Происходит при изменении состояния приложения в очереди установки. |