com3:ServiceServer

Статья
10/30/2023

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

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

<com3:ServiceServer>

Синтаксис

<com3:ServiceServer
    ServiceName = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    Arguments = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    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.' >

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

</com3ServiceServer>

Ключ

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

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

Атрибуты

Атрибут	Описание	Тип данных	Обязательно
ServiceName	Имя службы Windows, на котором размещается COM-сервер. Это имя службы должно совпадать с именем соответствующего элемента desktop6:Service в том же элементе Extensions уровня приложения в манифесте пакета.	Строка со значением от 1 до 32767 символов в длину с символами, не являющиеся пробелами в начале и конце.	Да
Аргументы	Параметры командной строки службы.	Строка со значением от 1 до 32767 символов в длину с символами, не являющиеся пробелами в начале и конце.	Нет
Отображаемое имя	Локализуемая строка, соответствующая значению ключа AppID по умолчанию.	Необязательная строка со значением от 1 до 256 символов в длину.	Нет
LaunchAndActivationPermission	Строка SDDL, соответствующая значению LaunchPermission ключа AppID.	Необязательное строковое значение SDDL .	Нет

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

Дочерний элемент	Описание
com3:Class	Определяет регистрацию класса для COM-сервера.

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

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

ServiceServer может иметь одну или несколько регистраций классов. Несколько регистраций классов должны совместно использовать ServiceServer , если их ключи LocalService совпадают и имеют один и тот же Идентификатор AppID (или если у них нет AppID), если они не должны быть зарегистрированы в разных элементах манифеста приложений или приложений.

Примеры

<?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)

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