uap5:OutOfProcessServer

Article
10/30/2023

Declares a package extension point of type windows.activatableClass.outOfProcessServer. This enables 3rd party WinRT classes defined in the app package to be called from a Win32 process.

Element hierarchy

<uap5:Extension>

<uap5:OutOfProcessServer>

Syntax

<uap5:OutOfProcessServer
  ServerName = 'An alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  RunFullTrust = 'A boolean value.' >

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

</uap5:OutOfProcessServer>

Key

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

Attributes and elements

Attributes

Attribute	Description	Data type	Required
ServerName	A string value of the server name.	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

Child elements

Child element	Description
Path	The path to the executable.
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.
ActivatableClass	Declares a runtime class associated with the extensibility point.

Parent elements

Parent element	Description
uap5:Extension	Declares an extensibility point for the app.

Remarks

This element is similar to the OutOfProcessServer element in Package/Extensions. Activate As Package behavior is implied by using this element in the Application/Extensions level of the manifest, indicating that the server token doesn't vary based on the activating process's token. In this context, the application identity claim matches the identity of the application it's contained in.

Requirements

Item	Value
Namespace	`http://schemas.microsoft.com/appx/manifest/uap/windows10/5`
Minimum OS Version	Windows 10 version 1709 (Build 16299)

Share via