OutOfProcessServer (Windows 10)

Artikel
10/30/2023

Deklariert einen Paketerweiterungspunkt vom Typ windows.activatableClass.outOfProcessServer. Die App verwendet eine ausführbare Datei (.exe), die eine oder mehrere aktivierbare Klassen verfügbar macht.

Elementhierarchie

<Paket>

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

Schlüssel

? optional (null oder 1) {} bestimmter Vorkommensbereich

Attribute und Elemente

Attribute

attribute	BESCHREIBUNG	Datentyp	Erforderlich
ServerName	Alle syntaktisch gültigen Zeichenfolgen, die innerhalb des Pakets eindeutig sind. Gemäß der Konvention ist dies der Name der ausführbaren Datei.	Eine alphanumerische Zeichenfolge (Punkte sind zulässig) mit einem Wert zwischen 1 und 255 Zeichen Länge. Muss mit einem Buchstaben beginnen.	Yes
RunFullTrust	Wenn true, wird der Server mit einem Windows Desktop-Brücke-Token im Gegensatz zu einem UWP-Token gestartet.	Ein optionaler boolescher Wert.	No
Identitytype	Der Aktivierungstyp des Servers.	Eine optionale Zeichenfolge, die einer der folgenden Werte sein kann: activateAsPackage oder activateAsActivator.	No

Untergeordnete Elemente

Untergeordnetes Element	Beschreibung
ActivatableClass (Typ: CT_OutOfProcessActivatableClass)	Deklariert eine Laufzeitklasse, die dem Erweiterbarkeitspunkt zugeordnet ist.
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 ausgeführt wird oder als mehrere Instanzen ausgeführt werden kann.
Pfad (Typ: ST_Executable)	Die ausführbare Standarddatei für die Erweiterung.

Übergeordnete Elemente

Übergeordnetes Element	BESCHREIBUNG
Erweiterung (im Typ: CT_PackageExtensions)	Deklariert einen Erweiterbarkeitspunkt für das Paket.

Hinweise

Wenn auf IdentityType festgelegt activateAsPackageist, wird der Server mit einem Token gestartet, das nicht abhängig vom Token des Aktivierungsprozesses variiert.

Beispiele

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

Anforderungen

Element	Wert
Namespace	`http://schemas.microsoft.com/appx/manifest/foundation/windows10`