Edit

com:Extension

Provides functionality to expose COM registrations to clients outside of the app package.

Element hierarchy

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

Syntax

<com:Extension
  Category = 'A required string that can have one of the following values: "windows.comServer", or "windows.comInterface".'
  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 -->
  com:ComServer?
  com:ComInterface?

</com: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.comServer, windows.comInterface (in Application); windows.comServer, windows.comInterface (in Package). 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
com:ComServer Declares a package extension point of type windows.comServer. The comServer extension may include four types of registrations: ExeServer, SurrogateServer, ProgId, or TreatAsClass.
com:ComInterface Declares a package extension point of type windows.comInterface. The comInterface extension may include three types of registrations: Interface, ProxyStub, or TypeLib.

Parent elements

Parent element Description
Extensions (in Package)
Extensions (in Application)

Requirements

Item Value
Namespace http://schemas.microsoft.com/appx/manifest/com/windows10
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

Examples

  • Last updated on