Festlegen der Exportmethode

  • Artikel

Sie können Funktionen auf zwei Weisen exportieren – mit einer DEF-Datei oder mit dem Schlüsselwort __declspec(dllexport). Berücksichtigen Sie bei der Entscheidung, welche Methode für Ihre DLL besser geeignet ist, die folgenden Fragestellungen:

  • Planen Sie später weitere Funktionen zu exportieren?

  • Wird Ihre DLL nur von Anwendungen verwendet, die Sie neu erstellen können, oder wird sie von Anwendungen verwendet, die Sie nicht neu erstellen können, z. B. Anwendungen, die von Drittanbietern erstellt wurden?

Vor- und Nachteile der Verwendung von DEF-Dateien

Durch das Exportieren von Funktionen in eine DEF-Datei erhalten Sie die Kontrolle über die Exportordnungszahlen. Wenn Sie der DLL eine exportierte Funktion hinzufügen, können Sie ihr einen höheren Ordnungszahlwert als jeder anderen exportierten Funktion zuweisen. Wenn Sie dies tun, müssen Anwendungen, die implizites Verknüpfen verwenden, nicht neu mit der Importbibliothek verknüpft werden, die die neue Funktion enthält. Dies ist sehr praktisch, wenn Sie eine DLL für viele Anwendungen entwerfen, da Sie neue Funktionen hinzufügen und zudem sicherstellen können, dass sie mit den Anwendungen, die sich bereits auf sie verlassen, weiterhin ordnungsgemäß funktioniert. Die MFC-DLLs werden beispielsweise mithilfe von DEF-Dateien erstellt.

Ein weiterer Vorteil bei der Verwendung einer DEF-Datei besteht darin, dass Sie das NONAME-Attribut verwenden können, um eine Funktion zu exportieren. Dadurch wird nur die Ordnungszahl in die Exporttabelle in der DLL eingefügt. Bei DLLs, die über eine große Anzahl von exportierten Funktionen verfügen, kann durch die Verwendung des NONAME-Attributs die Größe der DLL-Datei reduziert werden. Informationen dazu, wie Sie eine Moduldefinitionsanweisung schreiben, finden Sie unter Regeln für Moduldefinitionsanweisungen. Informationen zum Exportieren von Ordnungszahlen finden Sie unter Exportieren von Funktionen aus einer DLL über die Ordnungszahl statt über den Namen.

Ein Nachteil bei der Verwendung einer DEF-Datei besteht darin, dass Sie beim Exportieren von Funktionen in einer C++-Datei entweder die dekorierten Namen in die DEF-Datei einfügen oder die exportierten Funktionen mithilfe von extern "C" definieren müssen, um die vom MSVC-Compiler durchgeführte Namensergänzung zu vermeiden.

Wenn Sie die dekorierten Namen in die DEF-Datei einfügen müssen, können Sie diese mithilfe des Tools DUMPBIN oder mit der /MAP-Linkeroption abrufen. Die dekorierten Namen, die vom Compiler erzeugt werden, sind compilerspezifisch. Wenn Sie daher die vom Compiler erzeugten dekorierten Namen in eine DEF-Datei einfügen, müssen die Anwendungen, die auf die DLL verweisen, ebenfalls mit der gleichen Version des Compilers erstellt werden, sodass die dekorierten Namen in der aufrufenden Anwendung mit den exportierten Namen in der DEF-Datei der DLL übereinstimmen.

Vor- und Nachteile der Verwendung von „__declspec(dllexport)“

Die Verwendung von __declspec(dllexport) ist praktisch, da Sie sich nicht darum kümmern müssen, eine DEF-Datei zu verwalten und die dekorierten Namen der exportierten Funktionen abzurufen. Die Nützlichkeit dieser Exportmethode wird jedoch durch die Anzahl der verknüpften Anwendungen beschränkt, die Sie neu erstellen möchten. Wenn Sie die DLL mit neuen Exporten neu erstellen, müssen Sie auch die Anwendungen neu erstellen, da sich möglicherweise die dekorierten Namen für exportierte C++-Funktionen ändern, wenn Sie eine andere Version des Compilers für die Neuerstellung verwenden.

Wie möchten Sie vorgehen?

Worüber möchten Sie mehr erfahren?

Siehe auch

Exportieren aus einer DLL