Schnittstellenattribut
Die folgenden Attribute gelten für das C++-Schlüsselwort (oder __interface) der Schnittstelle.
| Attribute | Beschreibung |
|---|---|
| async_uuid | Gibt die UUID an, die den MIDL-Compiler angibt, um synchrone und asynchrone Versionen einer COM-Schnittstelle zu definieren. |
| custom | Hiermit können Sie Ihre eigenen Attribute definieren. |
| dispinterface | Fügt eine Schnittstelle in die IDL-Datei als Verteilschnittstelle ein. |
| dual | Platziert eine Schnittstelle in der IDL-Datei als duale Schnittstelle. |
| Export | Bewirkt, dass eine Datenstruktur in der IDL-Datei platziert wird. |
| helpcontext | Gibt eine Kontext-ID an, mit der der Benutzer Informationen zu diesem Element in der Hilfedatei anzeigen kann. |
| helpfile | Legt den Namen der Hilfedatei für eine Typbibliothek fest. |
| helpstring | Gibt eine Zeichenfolge an, die zum Beschreiben des Elements verwendet wird, auf das sie angewendet wird. |
| helpstringcontext | Gibt die ID eines Hilfethemas in einer HLP- oder CHM-Datei an. |
| helpstringdll | Gibt den Namen der DLL an, die zum Nachschlagen von Dokumentzeichenfolgen (Lokalisierung) verwendet werden soll. |
| hidden | Gibt an, dass das Element vorhanden ist, aber nicht in einem benutzerdefinierten Browser angezeigt werden soll. |
| library_block | Platziert ein Konstrukt im Bibliotheksblock der IDL-Datei. |
| local | Ermöglicht ihnen, den MIDL-Compiler als Headergenerator zu verwenden, wenn er im Schnittstellenheader verwendet wird. Wenn sie in einer einzelnen Funktion verwendet wird, wird eine lokale Prozedur festgelegt, für die keine Stubs generiert werden. |
| nonextensible | Gibt an, dass die IDispatch Implementierung nur die eigenschaften und Methoden enthält, die in der Schnittstellenbeschreibung aufgeführt sind und nicht zur Laufzeit mit zusätzlichen Membern erweitert werden können. Dieses Attribut ist nur auf einer dualen Schnittstelle gültig. |
| odl | Identifiziert eine Schnittstelle als ODL-Schnittstelle (Object Description Language). |
| object | Identifiziert eine benutzerdefinierte Schnittstelle. |
| oleautomation | Gibt an, dass eine Schnittstelle mit der Automatisierung kompatibel ist. |
| pointer_default | Gibt das Standardzeiger-Attribut für alle Zeiger mit Ausnahme von Zeigern auf oberster Ebene an, die in Parameterlisten angezeigt werden. |
| ptr | Legt einen Zeiger als vollständigen Zeiger fest. |
| restricted | Legt fest, welche Mitglieder der Bibliothek nicht willkürlich aufgerufen werden können. |
| uuid | Stellt die eindeutige ID für die Bibliothek bereit. |
Sie müssen diese Regeln zum Definieren einer Schnittstelle beachten:
Die Standardanrufkonvention ist __stdcall.
Wenn Sie keine GUID angeben, wird eine GUID angegeben.
Es sind keine überladenen Methoden zulässig.
Wenn Sie das uuid-Attribut nicht angeben und denselben Schnittstellennamen in verschiedenen Attributprojekten verwenden, wird dieselbe GUID generiert.