com3:ServiceServer

Registriert einen COM-Server (mit mindestens einer Klassenregistrierung), der in einem Windows-Dienst gehostet wird, der mit einem entsprechenden desktop6:Service-Element deklariert wird.

Elementhierarchie

<Package>
   └─ <Extensions>
      └─ <com3:Extension>
         └─ <com3:ComServer>
            └─ <com3:ServiceServer>
   └─ <Applications>
      └─ <Application>
         └─ <Extensions>
            └─ <com3:Extension>
               └─ <com3:ComServer>
                  └─ <com3:ServiceServer>

Syntax

<com3:ServiceServer
  ServiceName = 'A required string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  Arguments = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  DisplayName = 'An optional string between 1 and 256 characters in length. This string is localizable.'
  LaunchAndActivationPermission = 'An optional [SDDL string](/windows/win32/secauthz/security-descriptor-string-format).' >

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

</com3:ServiceServer>

Schlüssel

{} bestimmter Bereich von Vorkommen

Attribute

Merkmal Beschreibung Datentyp Erforderlich Standardwert
ServiceName Der Name des Windows Diensts, der den COM-Server hosten soll. Dieser Dienstname muss mit dem Namen eines entsprechenden Desktop6:Service-Elements im gleichen Element auf Anwendungsebene Extensions im Paketmanifest übereinstimmen. Eine Zeichenfolge zwischen 1 und 32767 Zeichen mit einem Nicht-Leerzeichen am Anfang und Ende. Yes
Argumente Die Befehlszeilenparameter des Diensts. Eine optionale Zeichenfolge zwischen 1 und 32767 Zeichen mit einem Nicht-Leerzeichen am Anfang und Ende. Nein
DisplayName Eine lokalisierbare Zeichenfolge, die dem Standardmäßigen AppID-Schlüsselwert entspricht. Eine optionale Zeichenfolge zwischen 1 und 256 Zeichen länge. Diese Zeichenfolge ist lokalisierbar. Nein
LaunchAndActivationPermission Eine SDDL-Zeichenfolge , die dem LaunchPermission-Wert des AppID-Schlüssels entspricht. Eine optionale SDDL-Zeichenfolge. Nein

Untergeordnete Elemente

Untergeordnetes Element Beschreibung
com3:Class Definiert eine Klassenregistrierung für den COM-Server.

Übergeordnete Elemente

Übergeordnetes Element Beschreibung
com:ComServer Deklariert einen Paketerweiterungspunkt vom Typ "windows.comServer". Die ComServer-Erweiterung kann vier Arten von Registrierungen umfassen: ExeServer, SurrogateServer, ProgId oder TreatAsClass.

Anforderungen

Element Wert
Namespace http://schemas.microsoft.com/appx/manifest/com/windows10/3
Mindestversion des Betriebssystems Windows 10 Version 2004 (Build 19041)

Bemerkungen

Ein ServiceServer kann eine oder mehrere Klassenregistrierungen haben. Mehrere Klassenregistrierungen sollten einen ServiceServer gemeinsam nutzen, wenn ihre LocalService-Schlüssel übereinstimmen und über dieselbe AppID verfügen (oder wenn sie keine AppID besitzen), es sei denn, sie müssen unter verschiedenen Applications/Application Manifestelementen registriert werden.

Beispiele

<?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>
  • Last updated on