com:Interface (nachfolger von com:Extension)

2024-10-23

Registriert neue COM-Schnittstellen.

Elementhierarchie

<-Paket->

<com:Interface>

<com:Interface>

Syntax

<com:Interface
    Id = 'An alphanumeric string separated by a period with a value between 1 and 255 characters in length (for example, Foo.Bar or Foo.Bar.1).'
    UseUniversalMarshaler = 'An optional boolean value.'
    ProxyStubClsid = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    SynchronousInterface = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    AsynchronousInterface = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.' >

  <!-- Child elements -->
  TypeLib?

</com:Interface>

Schlüssel

? optional (null oder eins)

Attribute und Elemente

Attribute

Attribut	Beschreibung	Datentyp	Erforderlich
-ID-	Eine Schnittstellen-ID (IID).	Eine alphanumerische Zeichenfolge, die durch einen Punkt zwischen 1 und 255 Zeichen getrennt ist (z. B. Foo.Bar oder Foo.Bar.1).	Ja
UseUniversalMarshaler	Legen Sie diesen Wert auf "true" fest, um den OLE Universal Marshaler als Proxy-Stub zu verwenden.	Ein optionaler boolescher Wert.	Nein
ProxyStubClsid-	Entspricht dem ProxyStubClsid32- Registrierungswert.	Eine optionale GUID im Format xx-xxxx-xxxx-xxxx-xxxx-xxxxxx.	Nein
SynchronInterface-	Die ID einer anderen Schnittstellenregistrierung, die asynchronInterface enthält, die auf diese Registrierung verweist. Die andere Schnittstelle muss sich in derselben comInterface-Erweiterung befinden.	Eine optionale GUID im Format xx-xxxx-xxxx-xxxx-xxxx-xxxxxx.	Nein
AsynchronousInterface-	Die ID einer anderen Schnittstellenregistrierung, die SynchronInterface enthält, die auf diese Registrierung verweist. Die andere Schnittstelle muss sich in derselben comInterface-Erweiterung befinden.	Eine optionale GUID im Format xx-xxxx-xxxx-xxxx-xxxx-xxxxxx.	Nein

Untergeordnete Elemente

Untergeordnetes Element	Beschreibung
com:TypeLib	Eine Typbibliothek für eine Schnittstelle.

Übergeordnete Elemente

Übergeordnetes Element	Beschreibung
com:ComInterface	Deklariert einen Paketerweiterungspunkt vom Typ windows.comInterface. Die ComInterface-Erweiterung kann drei Arten von Registrierungen umfassen: Interface, ProxyStuboder TypeLib.

Bemerkungen

Das ProxyStubClsid-Attribut muss auf die ID eines ProxyStub- in derselben comInterface- Erweiterung verweisen. ProxyStubClsid- kann nur für Proxy-Stubs mit einer Implementierung als Teil des Pakets verwendet werden. Um den OLE Universal Marshaler als Proxy-Stub zu verwenden, verwenden Sie stattdessen UseUniversalMarshaler.

Wenn UseUniversalMarshaler- "true" ist, muss die Schnittstellenregistrierung TypeLib-enthalten.

Anmerkung

ProxyStubClsid und UseUniversalMarshaler schließen sich gegenseitig aus.

Anforderungen

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