com:ComInterface

Description

Declares a package extension point of type windows.comInterface. The comInterface extension may include three types of registrations: Interface, ProxyStub, or TypeLib.

Element Hierarchy

<Package>
<Applications>
<Application>
<Extensions>
<com:Extension>
<com:ComInterface>

Syntax

<ComInterface>
  <!-- Child elements -->
  ( com:ProxyStub{0,1000},
  com:Interface{0,10000},
  com:TypeLib{0,1000}
  )
</ComInterface>

Key

{}   specific range of occurrences

Child Elements

Child Element Description
ProxyStub Registers a proxy stub.
Interface Registers new COM Interfaces.
TypeLib Registers a type library.

Remarks

The comInterface extension can be under the Application/Extensions/Extension manifest element, or under the Package/Extensions/Extension manifest element. There is no functional difference between these two options, but both placements have different advantages.

If the extension is under Application/Extensions/Extension, you can improve the readability of the manifest by keeping interface registrations near the class registrations that implement them. However, if you place the extension under Package/Extensions/Extension, you won't need to determine which Application to use for each interface. It's possible to use multiple comInterface extensions in either Application/Extensions/Extension or Package/Extensions/Extension, but this is neither recommended nor necessary.

Note

Any registrations in comInterface that depend on another registration (e.g. an Interface references a ProxyStub and/or a TypeLib) must be in the same comInterface extension.

Examples

Requirements

Value
Namespace http://schemas.microsoft.com/appx/manifest/com/windows10