EN
이 콘텐츠는 한국어로 제공되지 않아 영어 버전으로 표시됩니다.

Capability

Applies to Windows and Windows Phone

Declares a capability required by a package.

Element hierarchy

<Package>
<Capabilities>
<Capability>

Syntax

<Capability Name = "internetClient" | "internetClientServer" | "privateNetworkClientServer" | "documentsLibrary" | "picturesLibrary" | ... />

Attributes and Elements

Attributes

AttributeDescriptionData typeRequiredDefault value
Name

The name of the capability.

This attribute can have one of the following values:

  • internetClient
  • internetClientServer
  • privateNetworkClientServer
  • documentsLibrary
  • picturesLibrary
  • videosLibrary
  • musicLibrary
  • enterpriseAuthentication
  • sharedUserCertificates
  • removableStorage
Yes

 

Child Elements

None.

Parent Elements

Parent ElementDescription
Capabilities

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

 

Remarks

The following table describes the capability values.

CapabilityDescription
internetClientOn Windows, this provides access to your Internet connection for outgoing connections to the Internet. On Windows Phone, provides full local and internet access and can act as a server, but inbound access to critical ports is always blocked.
internetClientServerOn Windows, this provides access to your Internet connection, including incoming unsolicited connections from the Internet – the app can send information to or from your computer through a firewall. You do not need to declare internetClient if this capability is declared. On Windows Phone, provides full local and internet access and can act as a server, but inbound access to critical ports is always blocked.
privateNetworkClientServerOn Windows, this provides access to a home or work network – the app can send information to or from your computer and other computers on the same network. On Windows Phone, provides the same access as internetClient or internetClientServer.
documentsLibraryYour documents library, including the capability to add, change, or delete files. The package can only access file types that it has declared in the manifest. The app cannot access document libraries on HomeGroup computers.
picturesLibraryYour pictures library, including the capability to add, change, or delete files. This capability also includes pictures libraries on HomeGroup computers, along with picture file types on locally connected media servers.
videosLibraryYour videos library, including the capability to add, change, or delete files. This capability also includes videos libraries on HomeGroup computers, along with video file types on locally connected media servers.
musicLibraryYour music library and playlists, including the capability to add, change, or delete files. This capability also includes music libraries and playlists in the music library on HomeGroup computers, plus music file types on locally connected media servers.
enterpriseAuthenticationYour Windows credentials, for access to a corporate intranet. This application can impersonate you on the network.
sharedUserCertificatesSoftware and hardware certificates or a smart card – used to identify you in the app. This capability may be used by your employer, bank, or government services to identify you.
removableStorageRemovable storage, such as an external hard drive or USB flash drive, or MTP portable device, including the capability to add, change, or delete specific files. This package can only access file types that it has declared in the manifest.

 

If you add internet connection capabilities to your app, you need to also provide a link to your privacy policy on the Settings pane to pass app certification. See Guidelines for app settings for more info.

Examples

Here's an example of a Capabilities node.


<Capabilities>
  <Capability Name="internetClient"/>
  <Capability Name="musicLibrary"/>
  <Capability Name="videosLibrary"/>
  <DeviceCapability Name="microphone"/>
  <DeviceCapability Name="webcam"/>
</Capabilities>

See also

App capability declarations
Guidelines for app settings

Requirements

Namespace

http://schemas.microsoft.com/appx/2010/manifest

 

 

표시:
© 2014 Microsoft