com:Class (in SurrogateServer)

Definiert eine SurrogateServer-Klassenregistrierung.

Elementhierarchie

<Package>
   └─ <Extensions>
      └─ <com:Extension>
         └─ <com:ComServer>
            └─ <com:SurrogateServer>
               └─ <com:Class>
   └─ <Applications>
      └─ <Application>
         └─ <Extensions>
            └─ <com:Extension>
               └─ <com:ComServer>
                  └─ <com:SurrogateServer>
                     └─ <com:Class>

Syntax

<com:Class
  Path = 'A required string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  ThreadingModel = 'A required string that can have one of the following values: "Both", "STA", "MTA", "MainSTA", or "Neutral".'
  EnableOleDefaultHandler = 'An optional boolean value.'
  ProgId = 'An optional alphanumeric string separated by a period between 1 and 255 characters in length, e.g. Foo.Bar or Foo.Bar.1'
  VersionIndependentProgId = 'An optional alphanumeric string separated by a period 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 between 1 and 40 characters in length.'
  Id = 'A required GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
  DisplayName = 'An optional string between 1 and 256 characters in length. This string is localizable.' >

  <!-- Child elements -->
  com:ImplementedCategories?
  com:Conversion?
  com:DataFormats?
  com:MiscStatus?
  com:Verbs?
  com:DefaultIcon?
  com:ToolboxBitmap32?

</com:Class>

Schlüssel

? optional (null oder eins)

Attribute

Merkmal Beschreibung Datentyp Erforderlich Standardwert
Pfad Der vollständige Pfad zur Surrogate-Klassen-DLL. Eine Zeichenfolge zwischen 1 und 256 Zeichen, die diese Zeichen nicht enthalten können: <, , : >, ", ", |, ?, oder *. Ja
ThreadingModel Das Threadingmodell zum Laden von DLLs. Eine Zeichenfolge, die einen der folgenden Werte aufweisen kann: Beide, STA, MTA, MainSTA, Neutral. Ja
EnableOleDefaultHandler Dies sollte auf "true" festgelegt werden, wenn der Standardwert des InprocHandler32-Schlüssels "Ole32.dll" ist. Andernfalls sollte sie weggelassen werden. Der Standardwert ist "false". Ein optionaler boolescher Wert. No
Progid Ordnet eine programmgesteuerte ID (ProgID) einer CLSID zu. Eine optionale alphanumerische Zeichenfolge, die durch einen Punkt zwischen 1 und 255 Zeichen getrennt ist, 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 ermitteln. Eine optionale alphanumerische Zeichenfolge, die durch einen Punkt zwischen 1 und 255 Zeichen getrennt ist, z. B. Foo.Bar oder Foo.Bar.1 No
AutoConvertTo Gibt die automatische Konvertierung einer bestimmten Klasse von Objekten in eine neue Klasse von Objekten an. Eine optionale GUID im Format xx-xxxx-xxxx-xxxx-xxxx-xxxxxx. No
InsertableObject Gibt an, dass diese Klasse einfügebar ist. Ein optionaler boolescher Wert. No
ShortDisplayName Eine kurze Version des Anzeigenamens der Klasse. Eine optionale Zeichenfolge zwischen 1 und 40 Zeichen länge. No
ID Das Id-Attribut entspricht der CLSID. Eine GUID im Format xx-xxxx-xxxx-xxxx-xxxx-xxxxxx. Ja
DisplayName Eine lokalisierbare Zeichenfolge, die dem Standardwert des CLSID-Schlüssels entspricht. Eine optionale Zeichenfolge zwischen 1 und 256 Zeichen länge. Diese Zeichenfolge ist lokalisierbar. No

Untergeordnete Elemente

Untergeordnetes Element Beschreibung
com:ImplementedCategories Gibt Kategorien an, die von der Klasse implementiert werden.
com:Conversion Gibt die Formate an, die eine Anwendung lesen und schreiben kann.
com:DataFormats Gibt die Standard- und Hauptdatenformate an, die von einer Anwendung unterstützt werden.
com:MiscStatus Gibt an, wie ein Objekt erstellt und angezeigt wird.
com:Verben Gibt die Verben an, die für eine Anwendung registriert werden sollen.
com:DefaultIcon Stellt Standardsymbolinformationen für iconic-Präsentationen von Objekten bereit.
com:ToolboxBitmap32 Gibt den Modulnamen und die Ressourcen-ID für eine 16 x 16 Bitmap an, die für die Oberfläche einer Symbolleiste oder Toolboxschaltfläche verwendet werden soll.

Übergeordnete Elemente

Übergeordnetes Element Beschreibung
com:SurrogateServer Registriert einen SurrogateServer mit einer oder vielen Klassenregistrierungen.

Anforderungen

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

Bemerkungen

Klassenregistrierungen mit derselben AppId sollten einen SurrogateServer gemeinsam nutzen, es sei denn, sie müssen unter verschiedenen Applications/Application Manifestelementen registriert werden.

Das ThreadingModel entspricht dem InprocServer32-Threadingmodell . SurrogateServer-Klassenregistrierungen sollten über eine InprocServer32-Registrierung in der privaten Struktur des Pakets verfügen.

Beispiele