com:Class (в SurrogateServer/Class)

Статья
10/30/2023

Определяет регистрацию класса SurrogateServer.

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

<com:SurrogateServer>

<com:Class>

Синтаксис

<com:Class
    Id = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    Path = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    ThreadingModel = 'A string that can be one of the following values: "Both", "STA", "MTA", "MainSTA", "Neutral".'
    DisplayName = 'An optional string with a value between 1 and 256 characters in length. This string is localizable.'
    EnableOleDefaultHandler = 'An optional boolean value.'
    ProgId = 'An optional alphanumeric string separated by a period with a value between 1 and 255 characters in length (for example, Foo.Bar or Foo.Bar.1)'
    VersionIndependentProgId = 'An optional alphanumeric string separated by a period with a value between 1 and 255 characters in length (for example, Foo.Bar or Foo.Bar.1)'
    AutoConvertTo = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    InsertableObject = 'An optional boolean value.'
    ShortDisplayName = 'An optional string with a value between 1 and 40 characters in length.' >

  <!-- Child elements -->
  ( ImplementedCategories,
  Conversion?,
  DataFormats?,
  MiscStatus?,
  Verbs?,
  DefaultIcon?,
  ToolboxBitmap32? 
  )

</com:Class>

Ключ

? необязательный (ноль или единица)

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

Атрибуты

Атрибут	Описание	Тип данных	Обязательно
Id	Атрибут Id соответствует идентификатору CLSID.	GUID в формате xxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxx.	Да
Путь	Полный путь к библиотеке DLL суррогатного класса.	Строка со значением от 1 до 256 символов, которая не может содержать следующие символы: `<`, `>`, `:`, `"`, `\|`, `?`или `*`.	Да
ThreadingModel	Потоковая модель для загрузки библиотек DLL.	Строка, которая может иметь одно из следующих значений: Both, STA, MTA, MainSTA, Neutral.	Да
Отображаемое имя	Локализуемая строка, соответствующая значению ключа CLSID по умолчанию.	Необязательная строка со значением от 1 до 256 символов в длину.	Нет
EnableOleDefaultHandler	Это значение должно иметь значение true, если значение по умолчанию ключа InprocHandler32 — "Ole32.dll". В противном случае его следует опустить. Значением по умолчанию является false.	Необязательное логическое значение.	Нет
Progid	Связывает программный идентификатор (ProgID) с ИДЕНТИФИКАТОРом CLSID.	Необязательная буквенно-цифровая строка, разделенная точкой со значением от 1 до 255 символов (например, Foo.Bar или Foo.Bar.1).	Нет
VersionIndependentProgId	Связывает ProgID с CLSID. Это значение используется для определения последней версии приложения объекта.	Необязательная буквенно-цифровая строка, разделенная точкой со значением от 1 до 255 символов (например, Foo.Bar или Foo.Bar.1).	Нет
AutoConvertTo	Задает автоматическое преобразование заданного класса объектов в новый класс объектов.	Необязательный GUID в формате xxxxxxx-xxxx-xxxx-xxxx-xxxxxx.	Нет
InsertableObject	Указывает, что этот класс можно вставить.	Необязательное логическое значение.	Нет
ShortDisplayName	Краткая версия отображаемого имени класса.	Необязательная строка со значением от 1 до 40 символов в длину.	Нет

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

Дочерний элемент	Описание
Реализованные категории	Указывает категории, реализованные классом .
Преобразование	Указывает разрешения на чтение и запись класса.
Dataformats	Задает поддерживаемые форматы данных по умолчанию и main.
MiscStatus	Указывает способ создания и отображения объекта.
Глаголы	Указывает команды, которые будут зарегистрированы для приложения.
DefaultIcon	Предоставляет сведения о значках по умолчанию для знаковых представлений объектов.
ToolboxBitmap32	Определяет имя модуля и идентификатор ресурса для растрового изображения 16 x 16, используемого для лицевой стороны панели инструментов или кнопки панели элементов.

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

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

Регистрация классов с тем же AppId должна совместно использовать SurrogateServer, если только они не должны быть зарегистрированы в разных элементах манифеста приложений или приложений.

ThreadingModel соответствует модели потоков InprocServer32. Регистрация класса SurrogateServer должна иметь регистрацию InprocServer32 в частном кусте пакета.

Требования

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