OutOfProcessServer (Windows 10)

  • Article

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

<Paquet>

    <Extensions>

         <Extension>

              <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 Valeur par défaut
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