uap5:OutOfProcessServer

Artikel
10/30/2023

Deklariert einen Paketerweiterungspunkt vom Typ windows.activatableClass.outOfProcessServer. Dadurch können WinRT-Klassen von Drittanbietern, die im App-Paket definiert sind, aus einem Win32-Prozess aufgerufen werden.

Elementhierarchie

<Paket>

<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>

Schlüssel

? optional (null oder eins) {} bestimmter Vorkommensbereich

Attribute und Elemente

Attribute

attribute	BESCHREIBUNG	Datentyp	Erforderlich
ServerName	Ein Zeichenfolgenwert des Servernamens.	Eine alphanumerische Zeichenfolge zwischen 1 und 255 Zeichen. Muss mit einem alphabetischen Zeichen beginnen.	Yes
RunFullTrust	Wenn true, wird der Server mit einem Windows Desktop-Brücke-Token im Gegensatz zu einem UWP-Token gestartet.	Boolesch.	No
Identitytype	Der Aktivierungstyp des Servers.	Ein Zeichenfolgenwert, der wie folgt aussehen kann: activateAsPackage, activateAsActivator.	No

Untergeordnete Elemente

Untergeordnetes Element	Beschreibung
Pfad	Der Pfad zur ausführbaren Datei.
Argumente	Gibt die Liste der durch Trennzeichen getrennten Argumente an, die an die ausführbare Datei übergeben werden sollen.
Instanziierung	Gibt an, ob die ausführbare Datei als einzelne instance oder als mehrere Instanzen ausgeführt werden kann.
ActivatableClass	Deklariert eine Laufzeitklasse, die dem Erweiterbarkeitspunkt zugeordnet ist.

Übergeordnete Elemente

Übergeordnetes Element	BESCHREIBUNG
uap5:Extension	Deklariert einen Erweiterbarkeitspunkt für die App.

Hinweise

Dieses Element ähnelt dem OutOfProcessServer-Element in Package/Extensions. Das Verhalten "Als Paket aktivieren" wird durch die Verwendung dieses Elements auf der Ebene "Anwendung/Erweiterungen" des Manifests impliziert, was angibt, dass das Servertoken nicht abhängig vom Token des aktivierenden Prozesses variiert. In diesem Kontext stimmt der Anwendungsidentitätsanspruch mit der Identität der Anwendung überein, in der er enthalten ist.

Anforderungen

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