com3:Class (в ServiceServer)

  • Статья

Определяет регистрацию класса на COM-сервере, размещенном в службе Windows, которая зарегистрирована в элементе com3:ServiceServer .

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

<Пакет>

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

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

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

                   <com2:Extension>

                        com2:ComServer

                             com3:ServiceServer

                                  <com3:Class>

Синтаксис

<com3:Class
    Id = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    DisplayName = 'An optional string with a value between 1 and 256 characters in length.'
    EnableOleDefaultHandler = 'An optional boolean value.'
    ProgId = 'An optional alphanumeric string separated by a period with a value between 1 and 255 characters in length (e.g. 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 (e.g. 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? 
  
</com3:Class>

Ключ

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

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

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
Id Атрибут Id соответствует идентификатору CLSID (HKCR\CLSID{MyGuid}). GUID в формате xxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxx. Да
Отображаемое имя Локализуемая строка, соответствующая значению ключа 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, используемого для лицевой стороны панели инструментов или кнопки панели элементов.

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

Родительский элемент Описание
com3:ServiceServer Регистрирует COM-сервер (с одной или несколькими регистрациями классов), размещенный в службе Windows, объявленной с соответствующим элементом desktop6:Service .

Примеры

<?xml version="1.0" encoding="utf-8"?>
<Package IgnorableNamespaces="uap com com2 com3 desktop6"
         xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
         xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
         xmlns:desktop6="http://schemas.microsoft.com/appx/manifest/desktop/windows10/6"
         xmlns:com="http://schemas.microsoft.com/appx/manifest/com/windows10"
         xmlns:com2="http://schemas.microsoft.com/appx/manifest/com/windows10/2"
         xmlns:com3="http://schemas.microsoft.com/appx/manifest/com/windows10/3">
...
    <Applications>
        <Application ...>
            <Extensions>
                <desktop6:Extension Category="windows.service" Executable="ContosoPackagedService.exe" EntryPoint="packagedServiceComServer.service">
                    <desktop6:Service Name="examplePackagedServiceComServer" StartupType="manual" StartAccount="localService" /> 
                </desktop6:Extension>
                <com2:Extension Category="windows.comServer">
                    <com2:ComServer>
                        <com3:ServiceServer ServiceName="examplePackagedServiceComServer" DisplayName="ServicePackage public service server" 
                            LaunchAndActivationPermission="O:SYG:SYD:(A;;11;;;WD)(A;;11;;;RC)(A;;11;;;AC)(A;;11;;;AN)S:P(ML;;NX;;;S-1-16-0)">
                            <com3:Class Id="1BB09D24-6A0F-4C1F-BCB5-FB924324B2F5" DisplayName="CLSID_ContosoPublicServiceNoHandler"/>
                        </com3:ServiceServer>
                        <com3:TreatAsClass Id="2DAA3C97-F340-4C0E-B23C-92338974C5E9" DisplayName="CLSID_ContosoPublicServiceTreatAs" 
                            TreatAs="1BB09D24-6A0F-4C1F-BCB5-FB924324B2F5"/>
                        <com3:ProgId Id="ContosoPublicServiceNoHandler" Clsid="1BB09D24-6A0F-4C1F-BCB5-FB924324B2F5"/>
                        <com3:ProgId Id="ContosoPublicServiceNoHandler.1" CurrentVersion="ContosoPublicServiceNoHandler"/>
                    </com2:ComServer>
                </com2:Extension>
            </Extensions>
        </Application>
    </Applications>
</Package>

Требования

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