Freigeben über

com3:Class (in ServiceServer)

  • Artikel

Definiert eine Klassenregistrierung auf 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 1)

Attribute und Elemente

Attribute

attribute BESCHREIBUNG Datentyp Erforderlich Standardwert
Id Das Id-Attribut entspricht der CLSID (HKCR\CLSID{MyGuid}). Eine GUID im Format xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Yes
DisplayName Eine lokalisierbare Zeichenfolge, die dem Standardwert des CLSID-Schlüssels entspricht. Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen. No
EnableOleDefaultHandler Dies sollte auf TRUE festgelegt werden, wenn der Standardwert des InprocHandler32-Schlüssels "Ole32.dll" ist. Andernfalls sollte er weggelassen werden. Der Standardwert ist „FALSE“. Ein optionaler boolescher Wert. No
ProgId Ordnet einen programmgesteuerten Bezeichner (ProgID) einer CLSID zu. Eine optionale alphanumerische Zeichenfolge, getrennt durch einen Punkt mit einem Wert zwischen 1 und 255 Zeichen (z. B. Foo.Bar oder Foo.Bar.1). No
VersionIndependentProgId Ordnet eine ProgID einer CLSID zu. Dieser Wert wird verwendet, um die neueste Version einer Objektanwendung zu bestimmen. Eine optionale alphanumerische Zeichenfolge, getrennt durch einen Punkt mit einem Wert zwischen 1 und 255 Zeichen (z. B. Foo.Bar oder Foo.Bar.1). No
AutoConvertTo Gibt die automatische Konvertierung einer bestimmten Objektklasse in eine neue Klasse von Objekten an. Eine optionale GUID im Format xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. No
InsertableObject Gibt an, dass diese Klasse einfügbar ist. Ein optionaler boolescher Wert. No
ShortDisplayName Eine Kurzversion des Anzeigenamens der Klasse. Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 40 Zeichen. No

Untergeordnete Elemente

Untergeordnetes Element Beschreibung
ImplementiertCategories Gibt kategorien an, die von der -Klasse implementiert werden.
Konvertierung Gibt die Lese-/Schreibberechtigungen einer Klasse an.
Dataformats Gibt die unterstützten Standard- und Standard-Datenformate 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 mindestens einer Klassenregistrierung), der in einem Windows-Dienst gehostet wird, der mit einem entsprechenden desktop6:Service-Element deklariert ist.

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

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