com3:Class (in ServiceServer)

Definiert eine Klassenregistrierung in einem COM-Server, der in einem Windows-Dienst gehostet wird, der in einem com3:ServiceServer-Element registriert ist.

Elementhierarchie

<Paket>

    <Anwendungen>

         <Anwendung>

              <Erweiterungen>

                   <com2:Extension>

                        com2:ComServer

                             com3:ServiceServer

                                  <com3:Class>

Syntax

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

Schlüssel

? optional (null oder eins)

Attribute und Elemente

Attributes

attribute BESCHREIBUNG Datentyp Erforderlich Standardwert
Id Das Id-Attribut entspricht der CLSID (HKCR\CLSID{MyGuid}). Eine GUID in form xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxx. Ja
DisplayName Eine lokalisierbare Zeichenfolge, die dem Standardwert des CLSID-Schlüssels entspricht. Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen länge. Nein
EnableOleDefaultHandler Dies sollte auf "true" festgelegt werden, wenn der Standardwert des InprocHandler32-Schlüssels "Ole32.dll" lautet. Andernfalls sollte sie nicht angegeben werden. Der Standardwert ist „FALSE“. Ein optionaler boolescher Wert. Nein
Progid Verknüpft einen programmgesteuerten Bezeichner (ProgID) mit einer CLSID. Eine optionale alphanumerische Zeichenfolge, die durch einen Punkt mit einem Wert zwischen 1 und 255 Zeichen getrennt ist (z. B. Foo.Bar oder Foo.Bar.1). Nein
VersionIndependentProgId Verknüpft eine ProgID mit einer CLSID. Dieser Wert wird verwendet, um die neueste Version einer Objektanwendung zu ermitteln. Eine optionale alphanumerische Zeichenfolge, die durch einen Punkt mit einem Wert zwischen 1 und 255 Zeichen getrennt ist (z. B. Foo.Bar oder Foo.Bar.1). Nein
AutoConvertTo Gibt die automatische Konvertierung einer bestimmten Klasse von Objekten in eine neue Klasse von Objekten an. Eine optionale GUID im Formular xxxxxxxx-xxxx-xxxx-xxxxxxxx. Nein
InsertableObject Gibt an, dass diese Klasse eingefügt werden kann. Ein optionaler boolescher Wert. Nein
ShortDisplayName Eine kurze Version des Anzeigenamens der Klasse. Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 40 Zeichen länge. Nein

Untergeordnete Elemente

Untergeordnetes Element Beschreibung
ImplementierteCategories Gibt Kategorien an, die von der Klasse implementiert wurden.
Konvertierung Gibt die Lese-/Schreibberechtigungen einer Klasse an.
Dataformats Gibt die unterstützten Standard- und Hauptdatenformate an.
MiscStatus Gibt an, wie ein Objekt erstellt und angezeigt wird.
Verben Gibt die Verben an, die für eine Anwendung registriert werden sollen.
DefaultIcon Stellt Standardsymbolinformationen für ikonische Präsentationen von Objekten bereit.
ToolboxBitmap32 Gibt den Modulnamen und die Ressourcen-ID für eine 16 x 16 Bitmap an, die für das Gesicht einer Symbolleiste oder Toolboxschaltfläche verwendet werden soll.

Übergeordnete Elemente

Übergeordnetes Element Beschreibung
com3:ServiceServer Registriert einen COM-Server (mit einer oder mehreren Klassenregistrierungen), der in einem Windows-Dienst gehostet wird, der mit einem entsprechenden Desktop6:Service-Element deklariert wird.

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>

Anforderungen

Wert
Namespace http://schemas.microsoft.com/appx/manifest/com/windows10/3