Freigeben über


Compileroptionen-Makros

Diese Makros steuern bestimmte Compilerfeatures.

Makro Beschreibung
_ATL_ALL_WARNINGS Ein Symbol, das Fehler in Projekten ermöglicht, die aus früheren Versionen von ATL konvertiert wurden.
_ATL_APARTMENT_THREADED Definieren Sie, ob eines oder mehrere Ihrer Objekte Apartmentthreading verwenden.
_ATL_CSTRING_EXPLICIT_CONSTRUCTORS Macht bestimmte CString Konstruktoren explizit, wodurch unbeabsichtigte Konvertierungen verhindert werden.
_ATL_ENABLE_PTM_WARNING Definieren Sie dieses Makro, damit C++-Standardsyntax erforderlich ist. Er generiert den C4867-Compilerfehler, wenn nicht standardmäßige Syntax verwendet wird, um einen Zeiger auf eine Memberfunktion zu initialisieren.
_ATL_FREE_THREADED Definieren Sie, ob eines oder mehrere Ihrer Objekte freie oder neutrale Threading verwenden.
_ATL_MODULES Ermöglicht ihnen das Kompilieren von ATL-Projekten mit eingeschränkter Berechtigung und Verwendung von ATL mit C++-Modulen.
_ATL_MULTI_THREADED Ein Symbol, das angibt, dass das Projekt Objekte als "Both", "Frei" oder "Neutral" markiert hat. Stattdessen sollte das Makro _ATL_FREE_THREADED verwendet werden.
_ATL_NO_AUTOMATIC_NAMESPACE Ein Symbol, das die Standardmäßige Verwendung von Namespace als ATL verhindert.
_ATL_NO_COM_SUPPORT Ein Symbol, das verhindert, dass COM-bezogener Code mit Ihrem Projekt kompiliert wird.
ATL_NO_VTABLE Ein Symbol, das verhindert, dass der vtable-Zeiger im Konstruktor und Destruktor der Klasse initialisiert wird.
ATL_NOINLINE Ein Symbol, das angibt, dass eine Funktion nicht inlineiert werden soll.
_ATL_SINGLE_THREADED Definieren Sie, ob alle Objekte das Einzelthreadingmodell verwenden.

_ATL_ALL_WARNINGS

Ein Symbol, das Fehler in Projekten ermöglicht, die aus früheren Versionen von ATL konvertiert wurden.

#define _ATL_ALL_WARNINGS

Hinweise

Vor Visual C++ .NET 2002 deaktivierte ATL viele Warnungen und ließ sie deaktiviert, sodass sie nie im Benutzercode angezeigt wurden. Speziell:

  • C4127-bedingter Ausdruck ist konstant

  • C4786 'Identifier': Der Bezeichner wurde in den Debuginformationen auf "Zahl"-Zeichen abgeschnitten.

  • C4201 nicht standardmäßige Erweiterung verwendet : nameless struct/union

  • C4103 'filename': Verwendet #pragma Pack zum Ändern der Ausrichtung

  • C4291 "Deklaration": Es wurde kein übereinstimmende Operator gelöscht; Arbeitsspeicher wird nicht freigegeben, wenn die Initialisierung eine Ausnahme auslöst.

  • C4268 'identifier' : "const" static/global data initialized with compiler-generated default constructor fills the object with zeros

  • Nicht erreichbarer C4702-Code

In Projekten, die aus früheren Versionen konvertiert wurden, werden diese Warnungen weiterhin von den Bibliothekenheadern deaktiviert.

Um dieses Verhalten zu ändern, fügen Sie der Datei (stdafx.h in Visual Studio 2017 und früher) die folgende Zeile pch.h hinzu, bevor Sie Bibliothekenkopfzeilen einschließen.

#define _ATL_ALL_WARNINGS

Wenn dies #define hinzugefügt wird, achten die ATL-Header darauf, den Status dieser Warnungen beizubehalten, sodass sie nicht global deaktiviert werden (oder wenn der Benutzer explizit einzelne Warnungen deaktiviert, nicht zu aktivieren).

Neue Projekte haben diesen #define Satz standardmäßig in pch.h (stdafx.h in Visual Studio 2017 und früher).

_ATL_APARTMENT_THREADED

Definieren Sie, ob eines oder mehrere Ihrer Objekte Apartmentthreading verwenden.

_ATL_APARTMENT_THREADED

Hinweise

Gibt Apartmentthreading an. Weitere Optionen und eine Beschreibung der für ein ATL-Objekt verfügbaren Threadingmodelle finden Sie unter Angeben des Threadingmodells und der Optionen des Project-Assistenten für einfache Objekte ATL.

_ATL_CSTRING_EXPLICIT_CONSTRUCTORS

Macht bestimmte CString Konstruktoren explizit, wodurch unbeabsichtigte Konvertierungen verhindert werden.

_ATL_CSTRING_EXPLICIT_CONSTRUCTORS

Hinweise

Wenn dieser Konstruktor definiert ist, werden alle CString Konstruktoren, die einen einzelnen Parameter verwenden, mit dem expliziten Schlüsselwort kompiliert, wodurch implizite Konvertierungen von Eingabeargumenten verhindert werden. Dies bedeutet beispielsweise, dass beim Definieren, wenn _UNICODE Sie versuchen, eine char* Zeichenfolge als CString Konstruktorargument zu verwenden, ein Compilerfehler resultiert. Verwenden Sie dieses Makro in Situationen, in denen Sie implizite Konvertierungen zwischen schmalen und breiten Zeichenfolgentypen verhindern müssen.

Mithilfe des _T Makros für alle Konstruktorzeichenfolgenargumente können Sie Kompilierungsfehler definieren _ATL_CSTRING_EXPLICIT_CONSTRUCTORS und vermeiden, unabhängig davon, ob _UNICODE sie definiert sind.

_ATL_ENABLE_PTM_WARNING

Definieren Sie dieses Makro, um die Verwendung von ANSI C++-Standardkonformitätssyntax für Zeiger auf Memberfunktionen zu erzwingen. Wenn Sie dieses Makro verwenden, wird der C4867-Compilerfehler generiert, wenn nicht standardmäßige Syntax verwendet wird, um einen Zeiger auf eine Memberfunktion zu initialisieren.

#define _ATL_ENABLE_PTM_WARNING

Hinweise

Die ATL- und MFC-Bibliotheken wurden so geändert, dass sie der verbesserten C++-Standardkonformität des Microsoft C++-Compilers entsprechen. Gemäß dem ANSI C++-Standard sollte die Syntax eines Zeigers auf eine Klassenmememmfunktion lauten &CMyClass::MyFunc.

Wenn _ATL_ENABLE_PTM_WARNING nicht definiert ist (Standardfall), deaktiviert ATL/MFC den C4867-Fehler in Makrozuordnungen (insbesondere Meldungszuordnungen), sodass Code, der in früheren Versionen erstellt wurde, weiterhin wie zuvor erstellt werden kann. Wenn Sie definieren _ATL_ENABLE_PTM_WARNING, sollte Ihr Code dem C++-Standard entsprechen.

Die nicht standardmäßige Form ist jedoch veraltet. Sie müssen vorhandenen Code in die C++-Standardsyntax verschieben. Beispielsweise folgender Code:

BEGIN_MESSAGE_MAP(CMFCListViewDoc, CDocument)
   ON_COMMAND(ID_MYCOMMAND, OnMycommand)
END_MESSAGE_MAP()

Änderung erforderlich in:

BEGIN_MESSAGE_MAP(CMFCListViewDoc, CDocument)
   ON_COMMAND(ID_MYCOMMAND, &CMFCListViewDoc::OnMycommand)
END_MESSAGE_MAP()

Fügen Sie für Kartenmakros das kaufmännische Und-Zeichen "&" hinzu. Sie sollten das Zeichen nicht erneut in Ihrem Code hinzufügen.

_ATL_FREE_THREADED

Definieren Sie, ob eines oder mehrere Ihrer Objekte freie oder neutrale Threading verwenden.

_ATL_FREE_THREADED

Hinweise

Gibt freie Threading an. Free Threading entspricht einem Multithread-Apartmentmodell. Eine Beschreibung der für ein ATL-Objekt verfügbaren Threadingmodelle finden Sie unter Angeben des Threadingmodells für andere Threadingoptionen und Optionen, den ATL-Assistenten für einfache Objekte.

_ATL_MODULES

Ermöglicht ihnen, ATL-Projekte mit permissive- C++-Modulen zu kompilieren und zu verwenden.

_ATL_MODULES

_ATL_MULTI_THREADED

Ein Symbol, das angibt, dass das Projekt Objekte enthält, die als "Beide", "Frei" oder "Neutral" gekennzeichnet sind.

_ATL_MULTI_THREADED

Hinweise

Wenn dieses Symbol definiert ist, ruft ATL Code ab, der den Zugriff auf globale Daten ordnungsgemäß synchronisiert. Neuer Code sollte stattdessen das entsprechende Makro _ATL_FREE_THREADED verwenden.

_ATL_NO_AUTOMATIC_NAMESPACE

Ein Symbol, das die Standardmäßige Verwendung von Namespace als ATL verhindert.

_ATL_NO_AUTOMATIC_NAMESPACE

Hinweise

Wenn dieses Symbol nicht definiert ist, einschließlich atlbase.h der standardmäßigen Ausführung using namespace ATL , was zu Benennungskonflikten führen kann. Um dies zu verhindern, definieren Sie dieses Symbol.

_ATL_NO_COM_SUPPORT

Ein Symbol, das verhindert, dass COM-bezogener Code mit Ihrem Projekt kompiliert wird.

_ATL_NO_COM_SUPPORT

ATL_NO_VTABLE

Ein Symbol, das verhindert, dass der vtable-Zeiger im Konstruktor und Destruktor der Klasse initialisiert wird.

ATL_NO_VTABLE

Hinweise

Wenn der vtable-Zeiger daran gehindert wird, im Konstruktor und Destruktor der Klasse initialisiert zu werden, kann der Linker die vtable und alle Funktionen beseitigen, auf die sie verweist. Erweitert bis __declspec(novtable).

Beispiel

class ATL_NO_VTABLE CMyClass2 :

ATL_NOINLINE

Ein Symbol, das angibt, dass eine Funktion nicht inlineiert werden soll.

    ATL_NOINLINE inline
    myfunction()
    {
    ...
    }

Parameter

myfunction
Die Funktion, die nicht inlineiert werden soll.

Hinweise

Verwenden Sie dieses Symbol, wenn Sie sicherstellen möchten, dass eine Funktion nicht vom Compiler inline eingelinet wird, obwohl sie als Inline deklariert werden muss, damit sie in einer Headerdatei platziert werden kann. Erweitert bis __declspec(noinline).

_ATL_SINGLE_THREADED

Definieren, ob alle Objekte das Einzelthreadingmodell verwenden

_ATL_SINGLE_THREADED

Hinweise

Gibt an, dass das Objekt immer im primären COM-Thread ausgeführt wird. Eine Beschreibung der für ein ATL-Objekt verfügbaren Threadingmodelle finden Sie unter Angeben des Threadingmodells für andere Threadingoptionen und Optionen, den ATL-Assistenten für einfache Objekte.

Siehe auch

Makros