com3:SurrogateServer

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

元素层次结构

<包>

    <应用程序>

         <应用程序>

              <扩展>

                   <com2:Extension>

                        <com2:ComServer>

                             <com3:SurrogateServer>

语法

<com3: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 = 'An optional [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}

</com3: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 类注册。

父元素

父元素 描述
com2:ComServer 声明 类型为 windows.comServer 的包扩展点。 comServer 扩展可能包括以下类型的注册:ServiceServerExeServerSurrogateServerProgIdTreatAsClass

注解

如果 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/3
Minimum OS Version Windows 10版本 2004 (内部版本 19041)