OutOfProcessServer (Windows 10)

  • Статья

Объявляет точку расширения пакета типа windows.activatableClass.outOfProcessServer. Приложение использует исполняемый файл (.exe), который предоставляет один или несколько активируемых классов.

Иерархия элементов

<Пакет>

    <Расширения>

         <Расширение>

              <OutOfProcessServer>

Синтаксис

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

Ключ

? необязательный (ноль или один) {} определенный диапазон вхождений

Элементы и атрибуты

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
ServerName Любая синтаксически допустимая строка, уникальная в пределах пакета. По соглашению это имя исполняемого файла. Буквенно-цифровая строка (допускаются точки) со значением от 1 до 255 символов. Должен начинаться с буквы. Да
RunFullTrust Если значение равно true, сервер будет запущен с маркером windows мост для классических приложений, а не с маркером UWP. Необязательное логическое значение. Нет
IdentityType Тип активации сервера. Необязательная строка, которая может иметь одно из следующих значений: activateAsPackage или activateAsActivator. Нет

Дочерние элементы

Дочерний элемент Описание
ActivatableClass (тип: CT_OutOfProcessActivatableClass) Объявляет класс среды выполнения, связанный с точкой расширяемости.
Аргументы Указывает список аргументов с разделителями-запятыми для передачи исполняемому файлу.
Instancing Указывает, выполняется ли исполняемый файл как один экземпляр или как несколько экземпляров.
Путь (тип: ST_Executable) Исполняемый файл по умолчанию для расширения.

Родительские элементы

Родительский элемент Описание
Расширение (в типе: CT_PackageExtensions) Объявляет точку расширяемости для пакета.

Комментарии

IdentityType Если для задано значение activateAsPackage, сервер будет запущен с маркером, который не зависит от токена процесса активации.

Примеры

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

Требования

Элемент Значение
Пространство имен http://schemas.microsoft.com/appx/manifest/foundation/windows10