OutOfProcessServer (Windows 10)

Articolo
10/30/2023

Dichiara un punto di estensione del pacchetto di tipo windows.activatableClass.outOfProcessServer. L'app usa un eseguibile (.exe) che espone una o più classi attivabili.

Gerarchia degli elementi

<OutOfProcessServer>

Sintassi

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

Chiave

? facoltativo (zero o uno) {} intervallo specifico di occorrenze

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Obbligatoria
ServerName	Qualsiasi stringa sintatticamente valida univoca all'interno del pacchetto. Per convenzione, è il nome dell'eseguibile.	Stringa alfanumerica (i punti sono consentiti) con un valore compreso tra 1 e 255 caratteri. Deve iniziare con una lettera.	Sì
RunFullTrust	Se true, il server verrà avviato con un token di Windows Desktop Bridge anziché un token UWP.	Valore booleano facoltativo.	No
Identitytype	Tipo di attivazione del server.	Stringa facoltativa che può essere uno dei valori seguenti: activateAsPackage o activateAsActivator.	No

Elementi figlio

Elemento figlio	Descrizione
ActivatableClass (tipo: CT_OutOfProcessActivatableClass)	Dichiara una classe di runtime associata al punto di estendibilità.
Argomenti	Specifica l'elenco di argomenti delimitati da virgole da passare all'eseguibile.
Instancing	Specifica se l'eseguibile viene eseguito come singola istanza o può essere eseguito come più istanze.
Percorso (tipo: ST_Executable)	File eseguibile predefinito per l'estensione.

Elementi padre

Elemento padre	Descrizione
Estensione (in tipo: CT_PackageExtensions)	Dichiara un punto di estendibilità per il pacchetto.

Commenti

IdentityType Se è impostato su activateAsPackage, il server verrà avviato con un token che non varia in base al token del processo di attivazione.

Esempio

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

Requisiti

Elemento	Valore
Namespace	`http://schemas.microsoft.com/appx/manifest/foundation/windows10`