Partilhar via

OutOfProcessServer (Windows 10)

  • Artigo

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