desktop2:Extension (in Package/Extensions)

Declares an extensibility point for the app.

Element hierarchy

<Package>

    <Extensions>

         <desktop2:Extension>

Syntax

XML

<Extension
  Category = 'A string that can have one of the following values: "windows.firewallRules" or "windows.desktopEventLogging".' 
  Executable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isnt specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'An optional string with a value between 1 and 256 characters in length, representing the  task handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type. If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
  RuntimeType = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  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 with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:Parameters = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' >

  <!-- Child elements -->
  desktop2:FirewallRules
  desktop2:DesktopEventLogging?

</uap:Extension>

Key

? optional (zero or one)

Attributes and elements

Attributes

Attribute	Description	Data type	Required	Default value
Category	The category of the extension.	A string that can have one of the following values: windows.firewallRules or windows.desktopEventLogging.	Yes
Executable	The default launch executable.	An optional string with a value between 1 and 256 characters in length that must end with .exe and cannot contain these characters: <, >, :, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used. If specified, the EntryPoint property is also used. If that EntryPoint property isnt specified, the EntryPoint defined for the app is used.	No
EntryPoint	The activatable class ID.	An optional string with a value between 1 and 256 characters in length, representing the task handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type. If EntryPoint is not specified, the EntryPoint defined for the app is used instead.	No
RuntimeType	The runtime provider. This attribute is used typically when there are mixed frameworks in an app.	An optional string with a value 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 with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.	No
uap10:TrustLevel	Specifies the trust level of the extension.	An optional string that can have one of the following values: appContainer or 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, or win32App.	No
uap10:HostId	Specifies the ID of the host runtime for the extension.	An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.	No
uap10:Parameters	Contains command line parameters to pass to the extension. Only supported for desktop apps that have package identity.	A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.	No

Child elements

Child element	Description
AppPrinter	Enables the ability to install software file printers in Windows Desktop Bridge apps.
SearchFilterHandler	Enables Windows Desktop Bridge apps to register IFilters to extract file properties for searching.
SearchPropertyHandler	Enables Windows Desktop Bridge apps to install property handlers on your system.
DesktopEventLogging	Enables Windows Desktop Bridge apps to register for Windows event logging.
FirewallRules	Specifies firewall exception rules used by Windows Desktop Bridge apps.

Parent elements

Parent element	Description
desktop2:Extension	Declares an extensibility point for the app.

Requirements

Item	Value
Namespace	http://schemas.microsoft.com/appx/manifest/desktop/windows10/2
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Minimum OS Version	Windows 10 version 1703 (Build 15063)