OutOfProcessServer (Windows 10)

Article
10/30/2023

Déclare un point d’extension de package de type windows.activatableClass.outOfProcessServer. L’application utilise un exécutable (.exe) qui expose une ou plusieurs classes activables.

Hiérarchie d’éléments

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

Clé :

? plage d’occurrences (zéro ou une) {} spécifique facultative

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire
ServerName	Toute chaîne syntaxiquement valide qui est unique dans le package. Par convention, il s’agit du nom de l’exécutable.	Chaîne alphanumérique (les points sont autorisés) avec une valeur comprise entre 1 et 255 caractères. Doit commencer par une lettre.	Yes
RunFullTrust	Si la valeur est true, le serveur est lancé avec un jeton Windows Pont du bureau, par opposition à un jeton UWP.	Valeur booléenne facultative.	No
IdentityType	Type d’activation du serveur.	Chaîne facultative qui peut être l’une des valeurs suivantes : activateAsPackage ou activateAsActivator.	No

Éléments enfants

Élément enfant	Description
ActivateableClass (type : CT_OutOfProcessActivatableClass)	Déclare une classe runtime associée au point d’extensibilité.
Arguments	Spécifie la liste des arguments séparés par des virgules à passer à l’exécutable.
Instanciation	Spécifie si l’exécutable s’exécute comme une seule instance ou peut s’exécuter en tant que plusieurs instances.
Chemin d’accès (type : ST_Executable)	Exécutable par défaut pour l’extension.

Éléments parents

Élément parent	Description
Extension (en type : CT_PackageExtensions)	Déclare un point d’extensibilité pour le package.

Remarques

Si est IdentityType défini sur activateAsPackage, le serveur est lancé avec un jeton qui ne varie pas en fonction du jeton du processus d’activation.

Exemples

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

Configuration requise

Élément	Valeur
Espace de noms	`http://schemas.microsoft.com/appx/manifest/foundation/windows10`

Partager via