Condividi tramite


OutOfProcessServer (Windows 10)

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

<Pacchetto>

    <Estensioni>

         <Estensione>

              <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 Valore predefinito
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.
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