PackageManager.ProvisionPackageForAllUsersAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
ProvisionPackageForAllUsersAsync(String) |
Позволяет установить пакет приложения для всех пользователей на устройстве. |
ProvisionPackageForAllUsersAsync(String, PackageAllUserProvisioningOptions) |
Позволяет установить пакет приложения для всех пользователей на устройстве, включая параметры для указания дополнительных дополнительных пакетов для установки. |
ProvisionPackageForAllUsersAsync(String)
public:
virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ ProvisionPackageForAllUsersAsync(Platform::String ^ packageFamilyName) = ProvisionPackageForAllUsersAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> ProvisionPackageForAllUsersAsync(winrt::hstring const& packageFamilyName);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> ProvisionPackageForAllUsersAsync(string packageFamilyName);
function provisionPackageForAllUsersAsync(packageFamilyName)
Public Function ProvisionPackageForAllUsersAsync (packageFamilyName As String) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)
Параметры
- packageFamilyName
-
String
Platform::String
winrt::hstring
FamilyName устанавливаемого пакета приложения.
Возвращаемое значение
Ход выполнения и результат развертывания пакета приложения.
- Атрибуты
Требования к Windows
Семейство устройств |
Windows 10 Fall Creators Update (появилось в 10.0.16299.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v5.0)
|
Примеры
В этом примере показано добавление промежуточного или существующего зарегистрированного пакета для всех пользователей на устройстве.
using Windows.Foundation;
using Windows.Management.Deployment;
public void provisionForAllUsers(string inputPackageFamilyName)
{
var packageManager = new PackageManager();
var result = packageManager.ProvisionPackageForAllUsersAsync(inputPackageFamilyName).AsTask().Result;
if (result.ExtendedErrorCode != null)
{
System.Console.WriteLine("Error {0} provisioning {1}", result, inputPackageFamilyName);
throw result.ExtendedErrorCode.HResult;
}
}
Комментарии
Для подготовки пакета необходимо быть администратором. Подготовленный пакет приложения должен быть промежуточным и находиться на системном томе.
Если пакет уже подготовлен, выполняется "чистая" повторная подготовка. При "чистой" повторной подготовке будут удалены все предыдущие установки этого пакета, поэтому пакет будет вести себя так, как если бы это была его первая установка.
Примечание
При подготовке необязательных пакетов необходимо указать каждый необязательный пакет по отдельности с помощью собственного вызова метода. Начиная со сборки Windows 22000, можно использовать перегрузку ProvisionPackageForAllUsersAsync, чтобы указать дополнительные необязательные пакеты для установки с одним вызовом.
См. также раздел
Применяется к
ProvisionPackageForAllUsersAsync(String, PackageAllUserProvisioningOptions)
public:
virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ ProvisionPackageForAllUsersAsync(Platform::String ^ mainPackageFamilyName, PackageAllUserProvisioningOptions ^ options) = ProvisionPackageForAllUsersAsync;
/// [Windows.Foundation.Metadata.Overload("ProvisionPackageForAllUsersWithOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> ProvisionPackageForAllUsersAsync(winrt::hstring const& mainPackageFamilyName, PackageAllUserProvisioningOptions const& options);
[Windows.Foundation.Metadata.Overload("ProvisionPackageForAllUsersWithOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> ProvisionPackageForAllUsersAsync(string mainPackageFamilyName, PackageAllUserProvisioningOptions options);
function provisionPackageForAllUsersAsync(mainPackageFamilyName, options)
Public Function ProvisionPackageForAllUsersAsync (mainPackageFamilyName As String, options As PackageAllUserProvisioningOptions) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)
Параметры
- mainPackageFamilyName
-
String
Platform::String
winrt::hstring
FamilyName устанавливаемого пакета приложения.
Объект PackageAllUserProvisioningOptions , указывающий параметры подготовки.
Возвращаемое значение
Ход выполнения и результат развертывания пакета приложения.
- Атрибуты
Требования к Windows
Семейство устройств |
Windows 11 (появилось в 10.0.22000.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v14.0)
|
Комментарии
Для подготовки пакета необходимо быть администратором. Подготовленный пакет приложения должен быть промежуточным и находиться на системном томе.
Если пакет уже подготовлен, выполняется "чистая" повторная подготовка. При "чистой" повторной подготовке будут удалены все предыдущие установки этого пакета, поэтому пакет будет вести себя так, как если бы это была его первая установка.