Edit

com:ComServer

  • Article

Declares a package extension point of type windows.comServer. The comServer extension may include four types of registrations: ExeServer, SurrogateServer, ProgId, or TreatAsClass.

Element hierarchy

<Package>

    <Applications>

         <Application>

              <Extensions>

                   <com:Extension>

                        <com:ComServer>

Syntax

<com:ComServer>

  <!-- Child elements -->
  com:ExeServer{0,1000},
  com:SurrogateServer{0,1000},
  com:ProgId{0,10000},
  com:TreatAsClass{0,10000}

</com:ComServer>

Key

{}   specific range of occurrences

Attributes and elements

Attributes

None.

Child elements

Child element Description
com:ExeServer Registers an ExeServer with one or many class registrations.
com:SurrogateServer Registers an SurrogateServer with one or many class registrations.
com:ProgId A programmatic identifier (ProgID) that can be associated with a CLSID.
com:TreatAsClass A registration that corresponds to a CLSID registration with the TreatAs subkey.

Parent elements

Parent element Description
com:Extension Provides functionality to expose COM registrations to clients outside of the app package.

Remarks

In multi-application packages, it's important to place the COM server registration under the correct Applications/Application manifest element, because COM server processes will run with the identity of the ancestor Applications/Application element.

COM servers registered in the manifest always get Activate As Package (AAP) behavior, which means the COM server runs with the user session default token with package and application claims added. This is different from the default activation behavior of classically registered COM servers, in which the COM server runs with the client's token. For most applications, this difference will not be noticeable because clients typically run with the user session default token. Other activation behaviors, such as RunAs, are not supported.

Note

Any registrations in comServer that depend on another registration (e.g. a ProgId references a Class) must be in the same comServer extension.

It is possible to have multiple comServer extensions under the Applications/Application element, but that is neither necessary nor recommended.

Requirements

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