desktop2:包/扩展) 中的扩展 (

声明应用的扩展点。

元素层次结构

<包>

    <扩展>

         <desktop2:Extension>

语法

<Extension
  Category = 'A string that can have one of the following values: "windows.firewallRules" or "windows.desktopEventLogging".' 
  Executable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isnt specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'An optional string with a value between 1 and 256 characters in length, representing the  task handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type. If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
  RuntimeType = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  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 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.' >

  <!-- Child elements -->
  desktop2:FirewallRules
  desktop2:DesktopEventLogging?

</uap:Extension>

密钥

? 可选 (零个或一个)

特性和元素

属性

属性 说明 数据类型 必须 默认值
类别 扩展的类别。 可以具有以下值之一的字符串: windows.firewallRuleswindows.desktopEventLogging
可执行文件 默认启动可执行文件。 值长度介于 1 到 256 个字符之间的可选字符串,必须以 .exe 结尾,并且不能包含以下字符:<>:"|?、 或 *。 它指定扩展的默认可执行文件。 如果未指定,则使用为应用定义的可执行文件。 如果指定,则还使用 EntryPoint 属性。 如果未指定该 EntryPoint 属性,则使用为应用定义的 EntryPoint。
EntryPoint 可激活的类 ID。 值长度介于 1 到 256 个字符之间的可选字符串,表示处理扩展的任务。 这通常是 Windows 运行时类型的完全命名空间限定名称。 如果未指定 EntryPoint,则改用为应用定义的 EntryPoint。
RuntimeType 运行时提供程序。 当应用中存在混合框架时,通常会使用此属性。 值长度介于 1 到 255 个字符之间的可选字符串,不能以句点开头或结尾,也不能包含以下字符:<、、>:\/|"?、 或 。*
StartPage 处理扩展点的网页。 值长度介于 1 到 256 个字符之间的可选字符串,不能包含以下字符:<、、:>"|?、 或 *
uap10:TrustLevel 指定扩展的信任级别。 可具有以下值之一的可选字符串: appContainermediumIL
uap10:RuntimeBehavior 指定扩展的运行时行为。 可具有以下值之一的可选字符串: windowsApppackagedClassicAppwin32App
uap10:HostId 指定扩展的主机运行时的 ID。 值长度介于 1 到 255 个字符之间的可选字母数字字符串。 必须以字母开头。
uap10:Parameters 包含要传递给扩展的命令行参数。 仅支持具有包标识的桌面应用。 值长度介于 1 到 32767 个字符之间的字符串,开头和结尾处有一个非空格字符。

子元素

子元素 描述
AppPrinter 启用在 Windows 桌面桥 应用中安装软件文件打印机的功能。
SearchFilterHandler 使 Windows 桌面桥 应用能够注册 IFilters 以提取文件属性进行搜索。
SearchPropertyHandler 使 Windows 桌面桥应用能够在系统上安装属性处理程序。
DesktopEventLogging 使 Windows 桌面桥 应用能够注册 Windows 事件日志记录。
FirewallRules 指定 Windows 桌面桥应用使用的防火墙例外规则。

父元素

父元素 描述
desktop2:Extension 声明应用的扩展点。

要求

命名空间 http://schemas.microsoft.com/appx/manifest/desktop/windows10/2
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Minimum OS Version Windows 10版本 1703 (内部版本 15063)