Optionen für Compiler und Linker (C++/CX)

Eine Umgebungsvariable, C++/CX-Compileroptionen und Linkeroptionen unterstützen das Erstellen von Apps für die Windows-Runtime.

Bibliothekspfad

Die %LIBPATH%-Umgebungsvariable gibt den Standardpfad für die Suche nach WINMD-Dateien an.

Compileroptionen

Option Beschreibung
/ZW

/ZW:nostdlib
Aktiviert Windows-Runtime Spracherweiterungen.

Der nostdlib -Parameter verhindert, dass der Compiler den standardmäßigen, vordefinierten Suchpfad verwendet, um Assembly- und WINMD-Dateien zu finden.

Die Compileroption /ZW gibt die folgenden Compileroptionen implizit an:

- /Fi vccorlib.h: Erzwingt die Einbindung der Headerdatei „vccorlib.h“, die viele für den Compiler erforderliche Typen definiert.
- /FU Windows.winmd, wodurch die Einbeziehung der Vom Betriebssystem bereitgestellten Windows.winmd-Metadatendatei erzwungen wird und viele Typen in der Windows-Runtime definiert werden.
- /FU Platform.winmd: Erzwingt die Einbindung der Platform.winmd-Metadatendatei, die vom Compiler bereitgestellt wird und die meisten Typen in der Plattformfamilie von Namespaces definiert.
/AIdir Fügt ein durch den dir -Parameter angegebenes Verzeichnis zum Suchpfad hinzu, der vom Compiler für die Suche nach Assembly- und WINMD-Dateien verwendet wird.
/FUDatei Erzwingt die Einbindung des angegebenen Moduls oder der WINMD-Datei. Das heißt, Sie müssen die Datei nicht im Quellcode angeben.#using Der Compiler erzwingt automatisch die Einbindung der eigenen Windows-Metadatendatei „Platform.winmd“.
/D "WINAPI_FAMILY=2" Erstellt eine Definition, die die Verwendung einer Teilmenge des Win32 SDK ermöglicht, die mit dem Windows-Runtime kompatibel ist.

Linkeroptionen

Option Beschreibung
/APPCONTAINER[:NO] Markiert die ausführbare Datei als (nur) „im App-Container ausführbar“.
/WINMD[:{NO|ONLY}] Gibt eine WINMD-Datei und eine zugeordnete Binärdatei aus. Diese Option muss an den Linker übergeben werden, damit eine WINMD-Datei ausgegeben wird.

NO– Gibt keine WINMD-Datei, aber eine Binärdatei aus

ONLY– Gibt eine WINMD-Datei, aber keine Binärdatei aus
/WINMDFILE:Dateiname Der Name der auszugebenden WINMD-Datei, anstelle des Namens der WINMD-Standarddatei. Wenn mehrere Dateinamen in der Befehlszeile angegeben werden, wird der letzte Name verwendet.
/WINMDDELAYSIGN[:NO] Signiert die WINMD-Datei teilweise und platziert den öffentlichen Schlüssel in der Binärdatei.

NO– (Standard) Die WINMD-Datei wird nicht signiert.

/WINMDDELAYSIGN hat keine Auswirkung, sofern nicht /WINMDKEYFILE oder /WINMDKEYCONTAINER ebenfalls angegeben sind.
/WINMDKEYCONTAINER:Name Gibt einen Schlüsselcontainer zum Signieren einer Assembly an. Der Name -Parameter entspricht dem Schlüsselcontainer, der zum Signieren der Metadatendatei verwendet wird.
/WINMDKEYFILE:Dateiname Gibt einen Schlüssel oder ein Schlüsselpaar zum Signieren der Assembly an. Der Dateiname -Parameter entspricht dem Schlüssel, der zum Signieren der Metadatendatei verwendet wird.

Hinweise

Wenn Sie /ZWverwenden, stellt der Compiler automatisch eine Verknüpfung zur DLL-Version der C-Laufzeit (CRT) her. Das Verknüpfen mit der statischen Bibliotheksversion ist nicht zulässig, und die Verwendung von CRT-Funktionen, die in einer Universelle Windows-Plattform App nicht zulässig sind, führt zu einem Kompilierungsfehler.

Siehe auch

Erstellen von Apps und Bibliotheken