com3:SurrogateServer

Статья
10/30/2023

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

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

<com3:SurrogateServer>

Синтаксис

<com3: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 = 'An optional [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}

</com3: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.

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

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

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

Требования

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

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