com:SurrogateServer

  • 项目

使用一个或多个类注册注册代理服务器。

元素层次结构

<包>

    <应用程序>

         <应用程序>

              <扩展>

                   <com:Extension>

                        <com:ComServer>

                             <com:SurrogateServer>

语法

<com:SurrogateServer  
    CustomSurrogateExecutable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.'
    DisplayName = 'An optional string with a value between 1 and 256 characters in length. This string is localizable.'
    LaunchAndActivationPermission = 'A [SDDL string](/windows/win32/secauthz/security-descriptor-string-format) value.'
    AppId = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.' 
    SystemSurrogate = 'An optional string value.' >

  <!-- Child elements -->
  Class{1,10000}

</com:SurrogateServer>

密钥

{} 特定出现次数范围

特性和元素

属性

属性 说明 数据类型 必须 默认值
CustomSurrogateExecutable AppId 密钥中 DllSurrogate 的路径。 此路径相对于包根目录，必须引用包中的文件。 这与 SystemSurrogate 是互斥的。 值长度介于 1 到 256 个字符之间的可选字符串，该字符串必须以 .exe 结尾，并且不能包含以下字符：<、>、:、"、|?、 或* 否
DisplayName DisplayName 是对应于默认 AppID 密钥值的可本地化字符串。 值长度介于 1 到 256 个字符之间的可选字符串。 否
LaunchAndActivationPermission 与 AppID 密钥的 LaunchPermission 值相对应的 SDDL 字符串 。 SDDL 字符串值。 否
AppId 引用关联的 AppId 密钥的 AppId。 格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 的可选 GUID。 否
SystemSurrogate 一个值，该值对应于 AppId 键的 DllSurrogate 值的已知值。 这在 CustomSurrogateExecutable 中是互斥的。 可选的字符串值。 否

子元素

子元素 说明
类 定义 SurrogateServer 类注册。

父元素

子元素 说明
com:ComServer 声明 windows.comServer 类型的包扩展点。 comServer 扩展可能包括四种类型的注册：ExeServer、SurrogateServer、ProgId 或 TreatAsClass。

注解

如果 AppId 键中没有 DllSurrogate 的值，请不要使用 CustomSurrogateExecutable 属性。

LaunchAndActivationPermission 是一个 SDDL 字符串 ，它对应于 AppID 密钥的 LaunchPermission 值。

SystemSurrogate 对应于 AppId 键的 DllSurrogate 值的值。 例如，如果 DllSurrogate 值为 %System32%\prevhost.exe 或 %SysWow64%\prevhost.exe，则 SystemSurrogate 应设置为 PreviewHost ，并且不应设置 CustomSurrogateExecutable 。

要求

项 值
Namespace http://schemas.microsoft.com/appx/manifest/com/windows10
Minimum OS Version Windows 10版本 1703 (内部版本 15063)