/WHOLEARCHIVE (Alle Bibliotheksobjektdateien einbeziehen)

  • Artikel

Erzwingen Sie, dass der Linker alle Objektdateien in die statische Bibliothek in die verknüpfte ausführbare Datei einschließt.

Syntax

/WHOLEARCHIVE
/WHOLEARCHIVE:library

Argumente

Bibliothek
Optionaler Pfadname zu einer statischen Bibliothek. Der Linker enthält jede Objektdatei aus dieser Bibliothek.

Hinweise

Mit der Option "/WHOLEARCHIVE" wird der Linker gezwungen, jede Objektdatei aus einer angegebenen statischen Bibliothek einzuschließen, oder wenn keine Bibliothek angegeben ist, aus allen statischen Bibliotheken, die für den BEFEHL LINK angegeben sind. Um die Option "/WHOLEARCHIVE" für mehrere Bibliotheken anzugeben, können Sie mehrere /WHOLEARCHIVE-Schalter in der Befehlszeile des Linkers verwenden. Standardmäßig enthält der Linker Objektdateien nur dann in der verknüpften Ausgabe, wenn sie Symbole exportieren, auf die von anderen Objektdateien in der ausführbaren Datei verwiesen wird. Mit der Option "/WHOLEARCHIVE" wird der Linker alle In einer statischen Bibliothek archivierten Objektdateien so behandeln, als ob sie einzeln in der Befehlszeile des Linkers angegeben wurden.

Die Option "/WHOLEARCHIVE" kann verwendet werden, um alle Symbole aus einer statischen Bibliothek erneut zu exportieren. Auf diese Weise können Sie sicherstellen, dass alle Bibliothekscode, Ressourcen und Metadaten enthalten sind, wenn Sie eine Komponente aus mehreren statischen Bibliotheken erstellen. Wenn beim Erstellen einer statischen Bibliothek, die Windows-Runtime Komponenten für den Export enthält, eine 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

  1. Ö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).

  2. Klicken Sie auf der Eigenschaftenseite auf Konfigurationseigenschaften>Linker>Befehlszeile.

  3. Fügen Sie dem Textfeld "Zusätzliche Optionen" die /WHOLEARCHIVEOption hinzu.

Siehe auch

MSVC-Linkerreferenz
MSVC-Linkeroptionen