Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
com2:Extension
Provides functionality to expose COM registrations to clients outside of the app package.
Element hierarchy
<Package>
└─ <Extensions>
└─ <com2:Extension>
└─ <Applications>
└─ <Application>
└─ <Extensions>
└─ <com2:Extension>
Syntax
<com2: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: <, >, :, ", /, \, |, ?, 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 -->
com2:ComServer?
com2:ComInterface?
</com2: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 |
|---|---|
| com2:ComServer | Declares a package extension point of type windows.comServer. The comServer extension may include the following types of registrations: ServiceServer, ExeServer, SurrogateServer, ProgId, or TreatAsClass. |
| com2: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/2 |
| 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?