Attribute nach Verwendung
In diesem Thema werden Attribute entsprechend den C++-Sprachelementen aufgeführt, auf die sie angewendet werden.
Wenn einem Attribut ein Element vorangestellt wird, das sich nicht im Bereich des Attributs befindet, wird der Attributblock als Kommentar behandelt.
| Attribute | Beschreibung |
|---|---|
| Modulattribute | Gilt für das Modul-Attribut . |
| Schnittstellenattribut | Gilt für das schlüsselwort __interface C++. |
| Klassenattribute | Gilt für das C++-Schlüsselwort. |
| Methodenattribut | Gilt für die Methoden in einer Klasse, Coclass oder Schnittstelle. |
| Parameterattribute | Gilt für Parameter einer Methode in einer Klasse oder Schnittstelle. |
| Datenmemberattribute | Gilt für die Datenmember in einer Klasse, Coclass oder Schnittstelle. |
| typedef-, enum-, union- und struct-Attribute | Gilt für die C++-Schlüsselwörter. |
| Arrayattribute | Gilt für Arrays oder SAFEARRAYs. |
| Eigenständige Attribute | Funktioniert eher wie eine Codezeile, aber nicht für ein C++-Schlüsselwort. Eigenständige Attributanweisungen erfordern ein Semikolon am Ende der Zeile. |
| Benutzerdefinierte Attribute | Ermöglicht es dem Benutzer, Metadaten zu erweitern. |
Modulattribute
Das folgende Attribut kann nur auf das Modulattribute angewendet werden.
| Attribute | Beschreibung |
|---|---|
| helpstringdll | Gibt den Namen der DLL an, die zum Nachschlagen von Dokumentzeichenfolgen (Lokalisierung) verwendet werden soll. |
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.
Siehe auch
C++-Attribute für COM und .NET
Attribute nach Gruppen
Alphabetische Attributreferenz