Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

rescap3:Extension

Declares an extensibility point for the app.

Element hierarchy

<Package>
   └─ <Applications>
      └─ <Application>
         └─ <Extensions>
            └─ <rescap3:Extension>

Syntax

<rescap3:Extension
 Category = 'A required string that can have one of the following values: "windows.lockScreenComponent", or "windows.desktopAppMigration".'
 Executable = 'An optional string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.'
 EntryPoint = 'An optional string between 1 and 256 characters in length that cannot start or end with a whitespace character.'
 RuntimeType = 'An optional string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, &#124;, ?, or *.'
 StartPage = 'An optional string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
 ResourceGroup = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
 uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer", or "mediumIL".'
 uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
 uap10:HostId = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
 uap10:Parameters = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
 uap11:Id = 'An optional string between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
 uap11:Subsystem = 'An optional string that can have one of the following values: "console", or "windows".'
 uap11:SupportsMultipleInstances = 'An optional boolean value.'
 uap11:ResourceGroup = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
 uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *.'
 uap11:Parameters = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
 desktop7:CompatMode = 'An optional string that can have one of the following values: "classic", or "modern".'
 desktop7:Scope = 'An optional string that can have one of the following values: "machine", or "user".' >

 <!-- Child elements -->
 rescap3:DesktopAppMigration?

</rescap3:Extension>

Key

? optional (zero or one)

Attributes

Attribute Description Data type Required Default value
Category The type of extension. A string that must be one of the following values: windows.lockScreenComponent, windows.desktopAppMigration. Yes
Executable The default launch executable. An optional string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. No
EntryPoint The activatable class ID. An optional string between 1 and 256 characters in length that cannot start or end with a whitespace character. No
RuntimeType The runtime provider. Typically used when there are mixed frameworks in an app. An optional string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, , |, ?, or *. No
StartPage The web page that handles the extensibility point. An optional string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *. No
ResourceGroup A tag that you can use to group extension activations together for resource management purposes (for example, CPU and memory). An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character. No
uap10:TrustLevel Specifies the trust level of the extension. An optional string that can have one of the following values: appContainer, mediumIL. No
uap10:RuntimeBehavior Specifies the run time behavior of the extension. An optional string that can have one of the following values: windowsApp, packagedClassicApp, win32App. No
uap10:HostId Specifies the ID of the host runtime for the extension. An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character. No
uap10:Parameters Contains command line parameters to pass to the extension. Only supported for desktop apps that have package identity. An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. No
uap11:Id An identifier for the extension. The ID must be unique for all extensions in a package. An optional string between 1 and 255 characters in length with a non-whitespace character at its beginning and end. No
uap11:Subsystem This attribute is useful for non-UWP processes that need to be started with a specific subsystem. In most cases this should be left as the default. An optional string that can have one of the following values: console, windows. No
uap11:SupportsMultipleInstances Specifies whether the extension supports multiple instances. An optional boolean value. No
uap11:ResourceGroup A tag that you can use to group extension activations together for resource management purposes (for example, CPU and memory). An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character. No
uap11:CurrentDirectoryPath Specifies the initial directory when launching the process. An optional string that cannot contain these characters: <, >, |, ?, or *. No
uap11:Parameters Contains command line parameters to pass to the extension. An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. No
desktop7:CompatMode Specifies the compatibility mode for the extension. An optional string that can have one of the following values: classic, modern. No
desktop7:Scope Specifies whether the extension is per-user or per-machine. An optional string that can have one of the following values: machine, user. No

Child elements

Child element Description
rescap3:DesktopAppMigration Specifies where to redirect user tiles and pins to a Windows Desktop Bridge app.

Parent elements

Parent element Description
Extensions

Requirements

Item Value
Namespace http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3
desktop7 http://schemas.microsoft.com/appx/manifest/desktop/windows10/7
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
uap11 http://schemas.microsoft.com/appx/manifest/uap/windows10/11
Minimum OS Version Windows 10 version 1703 (Build 15063)

Remarks

windows.lockScreenComponent is an empty extension declaration that supports hosting UWP apps inside the welcome screen.

Examples

Feedback

Was this page helpful?

Additional resources

  • Last updated on