PackageManager.RegisterPackageByFullNameAsync Method

Definition

Registers a Package (the main package) by its full name and its dependency packages for the current user.

public:
 virtual IAsyncOperationWithProgress<DeploymentResult ^, DeploymentProgress> ^ RegisterPackageByFullNameAsync(Platform::String ^ mainPackageFullName, IIterable<Platform::String ^> ^ dependencyPackageFullNames, DeploymentOptions deploymentOptions) = RegisterPackageByFullNameAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> RegisterPackageByFullNameAsync(winrt::hstring const& mainPackageFullName, IIterable<winrt::hstring> const& dependencyPackageFullNames, DeploymentOptions const& deploymentOptions);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<DeploymentResult,DeploymentProgress> RegisterPackageByFullNameAsync(string mainPackageFullName, IEnumerable<string> dependencyPackageFullNames, DeploymentOptions deploymentOptions);
function registerPackageByFullNameAsync(mainPackageFullName, dependencyPackageFullNames, deploymentOptions)
Public Function RegisterPackageByFullNameAsync (mainPackageFullName As String, dependencyPackageFullNames As IEnumerable(Of String), deploymentOptions As DeploymentOptions) As IAsyncOperationWithProgress(Of DeploymentResult, DeploymentProgress)

Parameters

mainPackageFullName
String

Platform::String

winrt::hstring

A string that specifies the full name of the main package to be registered.

dependencyPackageFullNames

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Strings that specify the full names of the dependency packages to be registered.

deploymentOptions
DeploymentOptions

A DeploymentOptions-typed value that specifies the package deployment option.

Returns

The status of the deployment request. The DeploymentResult contains the final returned value of the deployment operation, once it is completed. The DeploymentProgress can be used to obtain the percentage of completion over the entire course of the deployment operation.

Attributes

Windows requirements

App capabilities
packageManagement

Remarks

To hide specifics about the manifest of a bundle package, instead of calling RegisterPackageAsync, you can call RegisterPackageByFullNameAsync to register a package by its full name. Bundle packages and regular packages are both referenced by the common package full name and thus registration by full name reduces the amount of domain knowledge required by the caller.

RegisterPackageByFullNameAsync can't install a package for any user other than the caller. The dependencyPackageFullNames can contain 0 elements if there aren't any dependency packages.

Applies to

See also