com2:Extension (Windows 10)

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

元素层次结构

<包>

     <应用程序>

          <应用程序>

               <扩展>

                    <com2:扩展>

     <扩展>

          <com2:扩展>

语法

<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.comServerwindows.comInterface 是的
uap10:TrustLevel 指定扩展的信任级别。 可选字符串值,可以是下列值之一:appContainermediumIL
uap10:RuntimeBehavior 指定扩展的运行时行为。 可选字符串值,可以是下列值之一:windowsApppackagedClassicApp,或 win32App
uap10:HostId 指定扩展的主机运行时的 ID。 一个可选的字母数字字符串,其长度介于 1 到 255 个字符之间。 必须以字母开头。
uap10:Parameters 包含要传递给扩展的命令行参数。 仅支持具有包标识的桌面应用。 一个长度介于 1 到 32767 个字符之间的字符串,其开头和结尾具有非空格字符。
uap11:Id 扩展的标识符。 ID 对于包中的所有扩展必须是唯一的。 一个可选字符串,其长度介于 1 到 255 个字符之间,其开头和结尾为非空格字符。
uap11:Subsystem 此属性继承自基本扩展语法,不适用于 com4 扩展。 除了语法验证之外,此值将被忽略。 一个可选字符串,可以具有以下值之一:控制台窗口
uap11:SupportsMultipleInstances 指定实例是否应在不同的进程中运行。 默认值为 false。 可选的布尔值。
uap11:ResourceGroup 一个标记,可用于将扩展激活组合在一起以进行资源管理(例如 CPU 和内存)。 可以设置 ResourceGroup 的值是自由格式且灵活的。 请参阅 Application@ResourceGroup 一个可选的字母数字字符串,其长度介于 1 到 255 个字符之间。 必须以字母开头。
uap11:CurrentDirectoryPath 指定启动应用程序进程时的初始目录。 此属性支持宏。 有关详细信息,请参阅包清单架构中的 宏。 不能包含以下字符的可选字符串:<>|?*。 >
uap11:Parameters 此属性继承自基本扩展语法,不适用于 com4 扩展。 除了语法验证之外,此值将被忽略。 此属性支持宏。 有关详细信息,请参阅包清单架构中的 宏。 一个可选字符串,其长度在 1 到 32767 个字符之间,其开头和结尾有非空格字符。
desktop7:CompatMode 指定此扩展的信息是以经典方式(例如,通过注册表向 COM 注册类型)还是以新的更作用域的方式向 Windows 注册。 默认值为“modern”。 CompatMode=“classic”需要 Microsoft.classicAppCompat_8wekyb3d8bbwe 功能。 可选字符串,可以具有以下值之一:经典新式
desktop7:范围 指定注册是否仅对作为已注册此包的用户运行的其他应用程序可见,或者是否对计算机上的所有用户和服务可见。 默认值为“user”。 Scope=“machine”需要 Microsoft.classicAppCompatElevated_8wekyb3d8bbwe 功能。 一个可选字符串,可以具有以下值之一:计算机用户

子元素

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

父元素

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

要求

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