com:SurrogateServer

Description

Registers a SurrogateServer with one or many class registrations.

Element Hierarchy

<Package>
<Applications>
<Application>
<Extensions>
<com:Extension>
<com:ComServer>
<com:SurrogateServer>

Syntax

<com:SurrogateServer  
    CustomSurrogateExecutable? = A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.
    DisplayName? = A string between 1 and 256 characters in length. This string is localizable.
    LaunchAndActivationPermission? = [SDDL string](https://aka.ms/sddl-string-format).
    AppId? = A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. 
    SystemSurrogate? = A string type. >

  <!-- Child elements -->
  Class{1,10000}
</com:SurrogateServer>

Key

{}   specific range of occurrences

Attributes

Attribute Description Data type Required
CustomSurrogateExecutable A path to the DllSurrogate in the AppId key. This path is relative to the package root and must reference a file in the package. This is mututally exclusive with SystemSurrogate. A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or * No
DisplayName DisplayName is a localizable string corresponding to the default AppID key value. A string between 1 and 256 characters in length. No
LaunchAndActivationPermission An SDDL string that corresponds to the LaunchPermission value of the AppID key. SDDL string. No
AppId The AppId that references the associated AppId key. A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. No
SystemSurrogate A value that corresponds to well-known values from the DllSurrogate value of the AppId key. This is mututally exclusive with CustomSurrogateExecutable. A string type No

Child Elements

Child Element Description
Class Defines a SurrogateServer class registration.

Remarks

If there is no value for the DllSurrogate in the AppId key, do not use the CustomSurrogateExecutable attribute.

LaunchAndActivationPermission is an SDDL string that corresponds to the LaunchPermission value of the AppID key.

The SystemSurrogate corresponds to the values of the DllSurrogate value of the AppId key. For example, if the DllSurrogate value is %System32%\prevhost.exe or %SysWow64%\prevhost.exe, then SystemSurrogate should be set to PreviewHost and the CustomSurrogateExecutable should not be set.

Examples

Requirements

Namespace

http://schemas.microsoft.com/appx/manifest/com/windows10