OutOfProcessServer (Windows 10)

Declares a package extension point of type windows.activatableClass.outOfProcessServer. The app uses an executable (EXE) that exposes one or more activatable classes.

Element hierarchy

<Package>
<Extensions>
<Extension>
<OutOfProcessServer>

Syntax

<OutOfProcessServer ServerName    = An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character. 
                    RunFullTrust? = Boolean.
                    IdentityType? = A string value that can be one of the following: activateAsPackage, activateAsActivator. >

  <!-- Child elements -->
  Path,
  Arguments?,
  Instancing,
  ActivatableClass{1,65535}

</OutOfProcessServer>

Key

?   optional (zero or one) {}   specific range of occurrences

Attributes and Elements

Attributes

Attribute Description Data type Required Default value
ServerName

The name of the executable.

An alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character. Yes
RunFullTrust

If true, the server will be launched with a Windows Desktop Bridge token, as opposed to a UWP token.

Boolean No
IdentityType

The activation type of the server.

A string value that can be one of the following: activateAsPackage, activateAsActivator. No activateAsActivator

 

Child Elements

Child Element Description
ActivatableClass (type: CT_OutOfProcessActivatableClass)

Declares a runtime class associated with the extensibility point.

Arguments

Specifies the list of comma-separated arguments to pass to the executable.

Instancing

Specifies whether the executable runs as a single instance or can run as multiple instances.

Path (type: ST_Executable)

The path to the executable.

 

Parent Elements

Parent Element Description
Extension (in type: CT_PackageExtensions)

Declares an extensibility point for the package.

Remarks

If the IdentityType is set to activateAsPackage, the server will be launched with a token that doesn't vary based on the activating process's token.

Examples

<Extension Category="windows.activatableClass.outOfProcessServer">
      <OutOfProcessServer ServerName="Microsoft.SDKSamples.ToastServer">
        <Path>Microsoft.Samples.ExeServerAuthoring.exe</Path>
        <Instancing>singleInstance</Instancing>
        <ActivatableClass ActivatableClassId="Microsoft.Samples.ExeServerAuthoring.Toaster" />
      </OutOfProcessServer>
</Extension>

Requirements

Value
Namespace http://schemas.microsoft.com/appx/manifest/foundation/windows10