OutOfProcessServer (Windows 10)

Article
10/30/2023

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

<OutOfProcessServer>

Syntax

<OutOfProcessServer
  ServerName = 'An alphanumeric string (dots are allowed) with a value between 1 and 255 characters in length. Must begin with a letter.' 
  RunFullTrust = 'An optional boolean value.'
  IdentityType = 'An optional string that can be one of the following values: "activateAsPackage" or "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
ServerName	Any syntactically valid string that's unique within the package. By convention, it's the name of the executable.	An alphanumeric string (dots are allowed) with a value between 1 and 255 characters in length. Must begin with a letter.	Yes
RunFullTrust	If true, the server will be launched with a Windows Desktop Bridge token, as opposed to a UWP token.	An optional boolean value.	No
IdentityType	The activation type of the server.	An optional string that can be one of the following values: activateAsPackage or activateAsActivator.	No

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 default executable for the extension.

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

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

Share via