com3:ServiceServer

Articolo
10/30/2023

Registra un server COM (con una o più registrazioni di classe) ospitate in un servizio Windows dichiarato con un elemento desktop6:Service corrispondente.

Gerarchia degli elementi

<com2:Extension>

<com2:ComServer>

<com3:ServiceServer>

Sintassi

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

Chiave

{} intervallo specifico di occorrenze

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Obbligatoria
Servicename	Nome del servizio Windows che ospita il server COM. Questo nome del servizio deve corrispondere al nome di un elemento desktop6:Service corrispondente nello stesso elemento Extensions a livello di applicazione nel manifesto del pacchetto.	Stringa con un valore compreso tra 1 e 32767 caratteri in lunghezza con un carattere non di spazi vuoti all'inizio e alla fine.	Sì
Argomenti	Parametri della riga di comando del servizio.	Stringa con un valore compreso tra 1 e 32767 caratteri in lunghezza con un carattere non di spazi vuoti all'inizio e alla fine.	No
DisplayName	Stringa localizzabile corrispondente al valore predefinito della chiave AppID.	Stringa facoltativa con un valore compreso tra 1 e 256 caratteri di lunghezza.	No
LaunchAndActivationPermission	Stringa SDDL che corrisponde al valore LaunchPermission della chiave AppID.	Valore di stringa SDDL facoltativo.	No

Elementi figlio

Elemento figlio	Descrizione
com3:Class	Definisce una registrazione della classe per il server COM.

Elementi padre

Elemento padre	Descrizione
com2:ComServer	Dichiara un punto di estensione del pacchetto di tipo windows.comServer. L'estensione comServer può includere i tipi di registrazioni seguenti: ServiceServer, ExeServer, SurrogateServer, ProgId o TreatAsClass.

Commenti

Un ServiceServer può avere una o più registrazioni di classe. Più registrazioni di classe devono condividere un ServiceServer se le chiavi LocalService corrispondono e hanno lo stesso AppID (o se non hanno un AppID ), a meno che non debbano essere registrate in diversi elementi manifesto applicazioni/applicazioni.

Esempio

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

Requisiti

Elemento	Valore
Namespace	`http://schemas.microsoft.com/appx/manifest/com/windows10/3`
Minimum OS Version	Windows 10 versione 2004 (Build 19041)

Condividi tramite