Edit

OutOfProcessServer (Windows 10)

  • Article

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 (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 Default value
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