OutOfProcessServer (Windows 10)

Статья
06/08/2023

Объявляет точку расширения пакета типа 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)	Объявляет точку расширяемости для пакета.

Примеры

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

Поделиться через