ATL
Nach oben zu Projektoptionen (Dialogfeld)
Projekt > Optionen > ATL
Verwenden Sie dieses Dialogfeld, um die Optionen für ATL (Active Template Library) anzugeben. Diese Optionen gelten für jeden COM-Server im Projekt.
Hinweis: DAX (das Delphi-ActiveX-Framework) hat ATL für C++-ActiveX- und COM-Projekte ab C++Builder XE ersetzt. Daher wird die Seite "ATL" erst in den Projektoptionen angezeigt, wenn Sie ein vorhandenes Projekt öffnen, das ATL verwendet. Informationen über die weitere Verwendung von ATL in C++Builder XE finden Sie unter C++Builder verwendet DAX für ActiveX und COM.
| Element | Beschreibung |
|---|---|
|
Einfach |
Für jeden Client wird eine Instanz des COM-Serverobjekts erstellt. |
|
Mehrfach |
Alle Clients arbeiten mit derselben Instanz des COM-Serverobjekts. |
|
APARTMENT-THREADED |
Ein Objekt wird nur durch den Thread referenziert, in dem es erstellt wurde. Diese Option sollte für Projekte verwendet werden, die nur Einzel-Thread- und Apartment-Thread-Objekte enthalten. |
|
MULTI-THREADED |
Objekte können von jedem Thread referenziert werden. Verwenden Sie diese Option für Projekte, die Objekte des freien, beidseitigen oder neutralen Thread-Modells enthalten. |
|
Einfach |
Alle COM-Serverobjekte werden mit einem einzigen Thread implementiert. |
|
Apartment |
Auch wenn das Projekt Multithread-fähig ist, benötigt jede Instanz des COM-Serverobjekts einen eigenen Thread für OLE-Aufrufe. |
|
Frei |
Das Projekt kann Multithread-fähig sein, und jede Instanz des COM-Serverobjekts kann gleichzeitige Aufrufe von verschiedenen Threads erhalten. Sie müssen dazu für Thread-Gleichzeitigkeit sorgen. |
|
Beides |
Entspricht Frei, außer dass ausgehende Aufrufe, wie z. B. Callbacks, garantiert im selben Thread ausgeführt werden. |
|
Neutral |
Mehrere Clients können das Objekt gleichzeitig in verschiedenen Threads aufrufen, aber COM stellt sicher, dass die Aufrufe nicht miteinander in Konflikt geraten. |
|
QueryInterface verfolgen |
Sendet eine Nachricht an das Ereignisprotokoll, sobald der Client einen QueryInterface-Aufruf ausführt. Das Ereignisprotokoll enthält auch den Status des Aufrufs. |
|
Ref-Zähler überprüfen |
Bei jeder Erhöhung oder Verringerung des Referenzzählers eines COM-Serverobjekts wird eine Nachricht an das Ereignisprotokoll gesendet. Wenn die Option Ref-Zähler überprüfen aktiviert ist und das Projekt versucht, das Objekt mit einem Referenzzähler ungleich 0 aus dem Speicher freizugeben, tritt eine Assertion auf. |
|
Allgemeine Ablaufverfolgung |
Wenn eine ATL-Funktion aufgerufen wird, wird eine Nachricht an das Ereignisprotokoll gesendet. |
Hinweis: Threading-Modell-Optionen wurden nur aus Gründen der Abwärtskompatibilität beibehalten. Sie geben die Threading-Modelle jetzt auf Objektbasis an.