OutOfProcessServer (Windows 10)

Declara um ponto de extensão de pacote do tipo windows.activatableClass.outOfProcessServer. O aplicativo usa um executável (.exe) que expõe uma ou mais classes ativáveis.

Hierarquia de elementos

<Pacote>

    <Extensões>

         <Extensão>

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

Chave

? opcional (zero ou um) {} intervalo específico de ocorrências

Atributos e elementos

Atributos

Atributo	Descrição	Tipo de dados	Obrigatório	Valor padrão
ServerName	Qualquer cadeia de caracteres sintaticamente válida que seja exclusiva dentro do pacote. Por convenção, é o nome do executável.	Uma cadeia de caracteres alfanumérica (os ponto são permitidos) com um valor entre 1 e 255 caracteres de comprimento. Deve começar com uma letra.	Yes
RunFullTrust	Se for true, o servidor será iniciado com um token Ponte de Desktop do Windows, em vez de um token UWP.	Um valor booliano opcional.	No
Identitytype	O tipo de ativação do servidor.	Uma cadeia de caracteres opcional que pode ser um dos seguintes valores: activateAsPackage ou activateAsActivator.	No

Elementos filho

Elemento filho	Descrição
ActivatableClass (tipo: CT_OutOfProcessActivatableClass)	Declara uma classe de runtime associada ao ponto de extensibilidade.
Argumentos	Especifica a lista de argumentos separados por vírgulas a serem passados para o executável.
Instanciação	Especifica se o executável é executado como uma única instância ou pode ser executado como várias instâncias.
Caminho (tipo: ST_Executable)	O executável padrão para a extensão.

Elementos pai

Elemento pai	Descrição
Extensão (no tipo: CT_PackageExtensions)	Declara um ponto de extensibilidade para o pacote.

Comentários

Se o IdentityType estiver definido como activateAsPackage, o servidor será iniciado com um token que não varia de acordo com o token do processo de ativação.

Exemplos

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

Requisitos

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