com2：扩展 (Windows 10)

  • 项目

提供向应用包外部的客户端公开 COM 注册的功能。

元素层次结构

<包>

    <应用程序>

         <应用程序>

              <扩展>

                   <com2:Extension>

语法

<com2:Extension
  Category = 'A string that can have one of the following values: "windows.comServer" or "windows.comInterface".' 
  uap10:TrustLevel = 'An optional string value that can be one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string value that can be 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.' 
  uap11:Id = 'An optional string with a value 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 with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
  uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  desktop7:CompatMode = 'An optional string the 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>

特性和元素

属性

属性 说明 数据类型 必须 默认值
类别 应用扩展点的类型。 可具有以下值之一的字符串： windows.comServer 或 windows.comInterface。 是
uap10：TrustLevel 指定扩展的信任级别。 可选字符串值，可以是以下值之一： appContainer 或 mediumIL。 否
uap10：RuntimeBehavior 指定扩展的运行时行为。 可选字符串值，可以是以下值之一： windowsApp、 packagedClassicApp 或 win32App。 否
uap10：HostId 指定扩展的主机运行时的 ID。 可选的字母数字字符串，其值长度介于 1 到 255 个字符之间。 必须以字母开头。 否
uap10：Parameters 包含要传递给扩展的命令行参数。 仅支持具有包标识的桌面应用。 一个字符串，其值长度介于 1 到 32767 个字符之间，开头和结尾处为非空格字符。 否
uap11：Id 扩展的标识符。 该 ID 对于包中的所有扩展必须是唯一的。 一个可选字符串，其值长度介于 1 到 255 个字符之间，开头和结尾处有一个非空格字符。 否
uap11：Subsystem 此属性继承自基本扩展语法，不适用于 com4 扩展。 除语法验证外，此值将被忽略。 可具有以下值之一的可选字符串： console 或 windows。 否
uap11：SupportsMultipleInstances 指定实例是否应在不同的进程中运行。 默认值为 false。 可选的布尔值。 否
uap11：ResourceGroup 一个标记，可用于将扩展激活分组到一起以进行资源管理， (例如 CPU 和内存) 。 可以设置的 ResourceGroup 值是自由格式且灵活的。 请参阅 Application@ResourceGroup。 可选的字母数字字符串，其值长度介于 1 到 255 个字符之间。 必须以字母开头。 否
uap11：CurrentDirectoryPath 指定启动应用程序进程时的初始目录。 不能包含以下字符的可选字符串：<、>、|?、 或 *。 > 否
uap11：Parameters 此属性继承自基本扩展语法，不适用于 com4 扩展。 除语法验证外，此值将被忽略。 一个可选字符串，其值长度在 1 到 32767 个字符之间，开头和结尾处有一个非空格字符。 否
desktop7：CompatMode 指定是否以经典方式向 Windows 注册此扩展的信息， (例如，未打包的应用通过注册表) 向 COM 注册类型，还是以范围更广的新方式注册类型。 默认值为“modern”。 CompatMode=“classic” 需要 Microsoft.classicAppCompat_8wekyb3d8bbwe 功能。 可选的字符串 可以具有以下值之一： 经典 或 新式。 否
desktop7：Scope 指定注册是否仅对以用户 (用户) 注册此包的用户身份运行的其他应用程序可见，或者它们是否对计算机上的所有用户和服务可见， (计算机) 。 默认值为“user”。 Scope=“machine”需要 Microsoft.classicAppCompatElevated_8wekyb3d8bbwe 功能。 可具有以下值之一的可选字符串： machine 或 user。 否

子元素

子元素 描述
com2:ComServer 声明 类型为 windows.comServer 的包扩展点。
com2:ComInterface 声明 类型为 windows.comInterface 的包扩展点。

父元素

父元素 描述
扩展 (类型：CT_ApplicationExtensions) 定义应用的一个或多个扩展点。

要求

项 值
Namespace http://schemas.microsoft.com/appx/manifest/com/windows10/2
uap10 元素 http://schemas.microsoft.com/appx/manifest/com/windows10/3
Minimum OS Version Windows 10版本 1709 (内部版本 16299)