com3:ServiceServer

Article
10/30/2023

Inscrit un serveur COM (avec une ou plusieurs inscriptions de classes) hébergé dans un service Windows déclaré avec un élément desktop6 :Service correspondant.

Hiérarchie d’éléments

<com2:Extension>

<com2:ComServer>

<com3:ServiceServer>

Syntax

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

Clé :

{} plage spécifique d’occurrences

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire
ServiceName	Nom du service Windows qui héberge le serveur COM. Ce nom de service doit correspondre au nom d’un élément desktop6 :Service correspondant dans le même élément Extensions au niveau de l’application dans le manifeste du package.	Chaîne dont la valeur est comprise entre 1 et 32767 caractères avec un caractère non-espace blanc au début et à la fin.	Yes
Arguments	Paramètres de ligne de commande du service.	Chaîne dont la valeur est comprise entre 1 et 32767 caractères avec un caractère non-espace blanc au début et à la fin.	No
DisplayName	Chaîne localisable correspondant à la valeur de clé AppID par défaut.	Chaîne facultative avec une valeur comprise entre 1 et 256 caractères.	No
LaunchAndActivationPermission	Chaîne SDDL qui correspond à la valeur LaunchPermission de la clé AppID.	Valeur de chaîne SDDL facultative.	No

Éléments enfants

Élément enfant	Description
com3:Class	Définit une inscription de classe pour le serveur COM.

Éléments parents

Élément parent	Description
com2:ComServer	Déclare un point d’extension de package de type windows.comServer. L’extension comServer peut inclure les types d’inscriptions suivants : ServiceServer, ExeServer, SurrogateServer, ProgId ou TreatAsClass.

Remarques

Un ServiceServer peut avoir une ou plusieurs inscriptions de classes. Plusieurs inscriptions de classes doivent partager un ServiceServer si leurs clés LocalService correspondent et qu’elles ont le même AppID (ou si elles n’ont pas d’AppID), sauf si elles doivent être inscrites sous différents éléments de manifeste Applications/Application.

Exemples

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

Configuration requise

Élément	Valeur
Espace de noms	`http://schemas.microsoft.com/appx/manifest/com/windows10/3`
Minimum OS Version	Windows 10 version 2004 (build 19041)

Partager via