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


com:SurrogateServer

Регистрирует SurrogateServer с одной или несколькими регистрациями классов.

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

<Пакет>

    <Приложения>

         <Приложение>

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

                   <com:Extension>

                        <com:ComServer>

                             <com:SurrogateServer>

Синтаксис

<com:SurrogateServer  
    CustomSurrogateExecutable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.'
    DisplayName = 'An optional string with a value between 1 and 256 characters in length. This string is localizable.'
    LaunchAndActivationPermission = 'A [SDDL string](/windows/win32/secauthz/security-descriptor-string-format) value.'
    AppId = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.' 
    SystemSurrogate = 'An optional string value.' >

  <!-- Child elements -->
  Class{1,10000}

</com:SurrogateServer>

Ключ

{} определенный диапазон вхождений

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

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
CustomSurrogateExecutable Путь к DllSurrogate в ключе AppId. Этот путь относится к корню пакета и должен ссылаться на файл в пакете. Это является мутантно исключающим с SystemSurrogate. Необязательная строка со значением от 1 до 256 символов в длину, которая должна заканчиваться .exe на и не может содержать следующие символы: <, >, :, ", |?, или* Нет
Отображаемое имя DisplayName — это локализуемая строка, соответствующая значению ключа AppID по умолчанию. Необязательная строка со значением от 1 до 256 символов. Нет
LaunchAndActivationPermission Строка SDDL, соответствующая значению LaunchPermission ключа AppID. Строковое значение SDDL. Нет
Appid Идентификатор приложения, который ссылается на связанный ключ AppId. Необязательный ИДЕНТИФИКАТОР GUID в формате xxxxxxx-xxxx-xxxx-xxxxxxx. Нет
SystemSurrogate Значение , соответствующее хорошо известным значениям из значения DllSurrogate ключа AppId. Это мутантно исключающее с Помощью CustomSurrogateExecutable. Необязательное строковое значение. Нет

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

Дочерний элемент Описание
Класс Определяет регистрацию класса SurrogateServer.

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

Дочерний элемент Описание
com:ComServer Объявляет точку расширения пакета типа windows.comServer. Расширение comServer может включать четыре типа регистраций: ExeServer, SurrogateServer, ProgId или TreatAsClass.

Комментарии

Если в ключе AppId нет значения для DllSurrogate, не используйте атрибут CustomSurrogateExecutable.

LaunchAndActivationPermission — это строка SDDL , соответствующая значению LaunchPermission ключа AppID.

SystemSurrogate соответствует значениям значения DllSurrogate ключа AppId. Например, если значение DllSurrogate равно %System32%\prevhost.exe или %SysWow64%\prevhost.exe, то systemSurrogate должно иметь значение PreviewHost , а значение CustomSurrogateExecutable не должно быть задано.

Требования

Элемент Значение
Пространство имен http://schemas.microsoft.com/appx/manifest/com/windows10
Minimum OS Version Windows 10 версии 1703 (сборка 15063)