Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
uap5:Extension
Declares an extensibility point for the app.
Element hierarchy
<Package>
└─ <Applications>
└─ <Application>
└─ <Extensions>
└─ <uap5:Extension>
Syntax
<uap5:Extension
Category = 'A required string that can have one of the following values: "windows.userActivity", "windows.mediaSource", "windows.videoRendererEffect", "windows.activatableClass.outOfProcessServer", "windows.startupTask", or "windows.appExecutionAlias".'
desktop11:AppLifecycleBehavior = 'An optional string that can have one of the following values: "systemManaged", or "unmanaged".'
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: <, >, :, ", /, \, |, ?, 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 -->
uap5:UserActivity?
uap5:MediaSource?
uap5:VideoRendererEffect?
uap5:OutOfProcessServer?
uap5:StartupTask?
uap5:AppExecutionAlias?
</uap5: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.userActivity, windows.mediaSource, windows.videoRendererEffect, windows.activatableClass.outOfProcessServer, windows.startupTask, windows.appExecutionAlias. | Yes | |
| desktop11:AppLifecycleBehavior | An optional string that can have one of the following values: systemManaged, unmanaged. | No | ||
| 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 |
|---|---|
| uap5:UserActivity | Allows an app to specify the web site associated with this application for cross platform UserActivity publishing. |
| uap5:MediaSource | Specifies the media source and the app service that it exposes. |
| uap5:VideoRendererEffect | Enables activation of video renderer effects in apps. |
| uap5:OutOfProcessServer | Declares a package extension point of type windows.activatableClass.outOfProcessServer. This enables 3rd party WinRT classes defined in the app package to be called from a Win32 process. |
| uap5:StartupTask | Specifies a startup task for your application. |
| uap5:AppExecutionAlias | Specifies the application's execution alias to determine the executable of the app to be activated. |
Parent elements
| Parent element | Description |
|---|---|
| Extensions |
Requirements
| Item | Value |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/manifest/uap/windows10/5 |
| desktop11 | http://schemas.microsoft.com/appx/manifest/desktop/windows10/11 |
| 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 1709 (Build 16299) |
Remarks
Examples
Feedback
Was this page helpful?