PrivilegedApplications element

Article
07/20/2015

The PrivilegedApplications element specifies the applications that will be allowed to access to the device with privileged rights.

Usage

<PrivilegedApplications>
  child elements
</PrivilegedApplications>

Attributes

There are no attributes.

Child elements

Element
Package

Child element sequence

Package

Parent elements

Element
SoftwareInfo

XSD

This is the XSD definition of the PrivilegedApplications element.

<!-- PrivilegedApplications Definition -->
<xs:complexType name="PrivilegedApplicationsType">
    <xs:choice>
      <xs:element name="AnyApplication" type="tns:AnyApplicationType" />
      <xs:element name="Package" type="tns:PackageForPrivilegedApplications" maxOccurs="unbounded" />
      <xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
    </xs:choice>
</xs:complexType>
<xs:complexType name ="AnyApplicationType">
</xs:complexType>

Remarks

The following points describe the use of the PrivilegedApplications element in a device metadata package:

The structure for the package identity is identical with the <Identity> element in the application manifest, so copy the elements from application manifest. Note Associate the app with the Windows Store, before copying from the app manifest, because the process of associating your app will update the app manifest elements. See Step 2: Create device metadata for your Windows Store device app for more information on associating the app with the store.
To specify multiple packages, list the multiple package elements in the PrivilegedApplications element.

This is an example of a <PrivilegedApplications> element.

<PrivilegedApplications>
    <Package>
          <Identity Name="64022FABRIKAM.FabrikamDeviceApp" 
              Publisher="CN=05558413-FFF6-4AA5-8176-AD43036533FA"
              AccessCustomDriver="false" />  
 </Package>
</PrivilegedApplications></SoftwareInfo>

Here is an example of the Application Manifest.

<?xml version="1.0" encoding="utf-8"?>
<Package xmlns="https://schemas.microsoft.com/appx/2010/manifest">
  <Identity Name="64022FABRIKAM.FabrikamDeviceApp" Publisher="CN=05558413-FFF6-4AA5-8176-AD43036533FA" Version="1.0.0.0" />
  <Properties>
    <DisplayName>Fabrikam Device App</DisplayName>
    <PublisherDisplayName>Fabrikam</PublisherDisplayName>
    <Logo>Assets\storeLogo-sdk.png</Logo>
  </Properties>
  <Prerequisites>
    <OSMinVersion>6.2</OSMinVersion>
    <OSMaxVersionTested>6.2</OSMaxVersionTested>
  </Prerequisites>
  <Resources>
    <Resource Language="x-generate" />
  </Resources>
  <Applications>
    <Application Id="DeviceAppForPrinters" Executable="$targetnametoken$.exe" 
        EntryPoint="DeviceAppForPrinters.App">
      <VisualElements DisplayName="Fabrikam Device App" Logo="Assets\squareTile-sdk.png" 
         SmallLogo="Assets\smallTile-sdk.png" Description="DeviceAppForPrinters" ForegroundText="light" BackgroundColor="#00b2f0" ToastCapable="true">
        <DefaultTile ShowName="allLogos" ShortName="App4PrinterCS" WideLogo="Assets\tile-sdk.png" />
        <SplashScreen Image="Assets\splash-sdk.png" BackgroundColor="#00b2f0" />
      </VisualElements>
      <Extensions>
          <Extension Category="windows.backgroundTasks" 
             EntryPoint="Fabrikam.Printing.PrintApp.PrintNotificationHandler">
               <BackgroundTasks>
                 <Task Type="systemEvent" />
               </BackgroundTasks>
          </Extension>
          <Extension Category="windows.printTaskSettings" 
             Executable="$targetnametoken$.exe" EntryPoint="DeviceAppForPrinters.App" />
      </Extensions>
    </Application>
  </Applications>
</Package>

The UMDF Fx2 sample provides a sample metadata package that demonstrates the PrivilegedApplications element.

Element information

Minimum supported system	Windows 8
Can be empty	No

Share via