com:SurrogateServer
使用一个或多个类注册注册代理服务器。
元素层次结构
<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) |