/WHOLEARCHIVE (Alle Bibliotheksobjektdateien enthalten)
Erzwingen Sie, dass der Linker alle Objektdateien in die statische Bibliothek in die verknüpfte ausführbare Datei einfing.
Syntax
/WHOLEARCHIVE
/WHOLEARCHIVE:library
Argumente
Bibliothek
Ein optionaler Pfadname zu einer statischen Bibliothek. Der Linker enthält jede Objektdatei aus dieser Bibliothek.
Bemerkungen
Die Option /WHOLEARCHIVE erzwingt, dass der Linker jede Objektdatei aus einer angegebenen statischen Bibliothek oder, wenn keine Bibliothek angegeben ist, aus allen statischen Bibliotheken, die für den LINK-Befehl angegeben sind, einschränkt. Um die Option /WHOLEARCHIVE für mehrere Bibliotheken anzugeben, können Sie mehr als einen /WHOLEARCHIVE-Schalter in der Linkerbefehlszeile verwenden. Standardmäßig schließt der Linker Objektdateien nur dann in die verknüpfte Ausgabe ein, wenn sie Symbole exportieren, auf die von anderen Objektdateien in der ausführbaren Datei verwiesen wird. Mit der Option /WHOLEARCHIVE behandelt der Linker alle in einer statischen Bibliothek archivierten Objektdateien so, als würden sie einzeln in der Linkerbefehlszeile angegeben.
Die Option /WHOLEARCHIVE kann verwendet werden, um alle Symbole aus einer statischen Bibliothek erneut zu exportieren. Auf diese Weise können Sie sicherstellen, dass der ganze Bibliothekscode, die Ressourcen und die Metadaten enthalten sind, wenn Sie eine Komponente aus mehr als einer statischen Bibliothek erstellen. Wenn beim Erstellen einer statischen Bibliothek, die Windows-Runtime-Komponenten für den Export enthält, die Warnung LNK4264 angezeigt wird, verwenden Sie die Option /WHOLEARCHIVE, wenn Sie diese Bibliothek mit einer anderen Komponente oder App verknüpfen.
Die Option /WHOLEARCHIVE wurde in Visual Studio 2015 Update 2 eingeführt.
So legen Sie diese Linkeroption in Visual Studio fest
Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts. Weitere Informationen erhalten Sie unter Set C++ compiler and build properties in Visual Studio (Festlegen der Compiler- und Buildeigenschaften (C++) in Visual Studio).
Klicken Sie auf der Eigenschaftenseite auf Konfigurationseigenschaften>Linker>Befehlszeile.
Fügen Sie die
/WHOLEARCHIVEOption zum Textfeld Zusätzliche Optionen hinzu.