Edit

uap5:OutOfProcessServer

  • Article

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

<Package>

    <Applications>

         <Application>

              <Extensions>

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