Package.MachineExternalLocation Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets the location of the machine-wide external folder specified in the package manifest for the current package.
public:
property StorageFolder ^ MachineExternalLocation { StorageFolder ^ get(); };StorageFolder MachineExternalLocation();public StorageFolder MachineExternalLocation { get; }var storageFolder = package.machineExternalLocation;Public ReadOnly Property MachineExternalLocation As StorageFolderProperty Value
The location of the machine-wide external folder specified in the package manifest for the current package.
Windows requirements
| Device family |
Windows 10, version 2004 (introduced in 10.0.19041.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced in v10.0)
|
Remarks
The external folder is a disk location outside of the package where the package manifest can reference application content. This property returns the location of the external folder as a StorageFolder object for an app that is provisioned for all users on the machine.
This property is intended to be used when you are granting package identity by packaging with external location. A package with external location contains only a package manifest (not an executable or other application content). The package manifest references application content in an external disk location outside of the package.
To set the external folder, use one of the following combinations of PackageManager methods and related options properties:
- AddPackageByUriAsync: Set the ExternalLocationUri property of the options parameter.
- RegisterPackageByUriAsync: Set the ExternalLocationUri property of the options parameter.
- StagePackageByUriAsync: Set the ExternalLocationUri property of the options parameter.