Edit

Capabilities (Windows 10)

  • Article

Declares the access to protected user resources that the package requires.

Element hierarchy

<Package>

    <Capabilities>

Syntax

<Capabilities>

  <!-- Child elements -->
  Capability{0,100},
  uap:Capability{0,100},
  DeviceCapability{0,100},
  mobile:Capability{0,100},
  rescap:Capability{0,100},
  uap:Capability{0,100},
  uap2:Capability{0,100},
  uap3:Capability{0,100},
  uap4:Capability{0,100},
  uap4:CustomCapability{0,100},
  uap7:Capability{0,100},
  uap11:Capability{0,100}
  
</Capabilities>

Key

{}   specific range of occurrences

Attributes and elements

Attributes

None.

Child elements

Child element Description
Capability Declares a capability required by a package.
DeviceCapability Declares a device capability required by a package. On Windows 10.0.10240.0, can contain up to 100 [Device](element-device.md) elements. On Windows 10.0.10586.0, can contain up to 1000 (for syntax and examples, see Examples).
mobile:Capability Declares a capability required by a package. (mobile)
rescap:Capability Declares a restricted capability required by a package.
uap2:Capability Declares a capability required by a package. (uap2)
uap3:Capability Declares a capability required by a package. (uap3)
uap4:Capability Declares a capability required by a package. (uap4)
uap4:CustomCapability Declares a custom capability required by a package. (uap4)
uap11:Capability Declares a capability required by a package. (uap11)

Parent elements

Parent element Description
Package Defines the root element of an app package manifest. The manifest describes the structure and capabilities of the software to the system.

Remarks

If you don't explicitly declare the capabilities required for your app to access user resources, your app can't access that resource. However, even if you declare a capability, your app still won't have access to the user resource if it doesn't exist on the system or there are other security policies in place that limit access to the resource.

Examples

Here's an example of the Capabilities node.

<Capabilities>
    <Capability Name="internetClient"/>
    <Capability Name="internetClientServer"/>
    <Capability Name="privateNetworkClientServer"/>
    <Capability Name="allJoyn"/>
    <uap:Capability Name="documentsLibrary"/>
    <uap:Capability Name="picturesLibrary"/>
    <uap:Capability Name="videosLibrary"/>
    <uap:Capability Name="musicLibrary"/>
    <uap:Capability Name="enterpriseAuthentication"/>
    <uap:Capability Name="sharedUserCertificates"/>
    <uap:Capability Name="userAccountInformation"/>
    <uap:Capability Name="removableStorage"/>
    <uap:Capability Name="appointments"/>
    <uap:Capability Name="contacts"/>
    <uap:Capability Name="phoneCall"/>
    <uap:Capability Name="blockedChatMessages"/>
    <uap:Capability Name="objects3D"/>
    <mobile:Capability Name="recordedCallsFolder"/>
</Capabilities>

See also

App capability declarations

Requirements

Item Value
Namespace http://schemas.microsoft.com/appx/manifest/foundation/windows10