OutOfProcessServer (Windows 10)

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

Elementhierarchie

<Paket>

    <Erweiterungen>

         <Erweiterung>

              <OutOfProcessServer>

Syntax

<OutOfProcessServer
  ServerName = 'An alphanumeric string 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 ein) {} bestimmter Vorkommensbereich

Attribute und Elemente

Attributes

attribute BESCHREIBUNG Datentyp Erforderlich Standardwert
ServerName Der Name der ausführbaren Datei. Eine alphanumerische Zeichenfolge mit einem Wert zwischen 1 und 255 Zeichen länge. Muss mit einem Buchstaben beginnen. Ja
RunFullTrust Wenn true, wird der Server mit einem Windows-Desktop-Brücke-Token gestartet, im Gegensatz zu einem UWP-Token. Ein optionaler boolescher Wert. Nein
Identitytype Der Aktivierungstyp des Servers. Eine optionale Zeichenfolge, die eine der folgenden Werte sein kann: activateAsPackage oder activateAsActivator. Nein

Untergeordnete Elemente

Untergeordnetes Element Beschreibung
Aktivierungsklasse (Typ: CT_OutOfProcessActivatableClass) Deklariert eine Laufzeitklasse, die dem Erweiterungspunkt zugeordnet ist.
Argumente Gibt die Liste der kommatrennten Argumente an, die an die ausführbare Datei übergeben werden sollen.
Instanziierung Gibt an, ob die ausführbare Datei als einzelne Instanz ausgeführt wird oder als mehrere Instanzen ausgeführt werden kann.
Pfad (Typ: ST_Executable) Der Pfad zur ausführbaren Datei.

Übergeordnete Elemente

Übergeordnetes Element Beschreibung
Erweiterung (in Typ: CT_PackageExtensions) Deklariert einen Erweiterungspunkt für das Paket.

Bemerkungen

Wenn der IdentityType Server auf activateAsPackage"" festgelegt ist, wird der Server mit einem Token gestartet, das sich nicht auf dem Token des Aktivierungsprozesses unterscheidet.

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

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