/EXPORT (Funktion exportieren)
Aktualisiert: November 2007
/EXPORT:entryname[,@ordinal[,NONAME]][,DATA]
Hinweise
Mithilfe dieser Option können Sie eine Funktion aus Ihrem Programm exportieren, damit andere Programme die Funktion aufrufen können. Sie können Daten auch exportieren. Exporte werden gewöhnlich in einer DLL definiert.
entryname steht dabei für den Namen der Funktion oder des Datenelements, wie es vom aufrufenden Programm verwendet werden soll. Mit ordinal wird ein Index in die Exporttabelle im Bereich 1 bis 65.535 geschrieben. Falls Sie keine Ordnungszahl angeben, wird eine von LINK zugewiesen. Durch das NONAME-Schlüsselwort wird die Funktion ohne entryname nur als Ordnungszahl exportiert.
Das Schlüsselwort DATA legt fest, dass das exportierte Element ein Datenelement ist. Das Datenelement im Clientprogramm muss mithilfe von extern __declspec(dllimport) deklariert werden.
Es gibt drei Methoden zum Exportieren einer Definition. Sie sind in der Reihenfolge aufgeführt, in der sie verwendet werden sollten:
__declspec(dllexport) im Quellcode
Eine EXPORTS-Anweisung in einer DEF-Datei
Eine /EXPORT-Spezifikation in einem LINK-Befehl
Es ist möglich, alle drei Methoden im selben Programm einzusetzen. Wenn LINK ein Programm erstellt, das Exporte enthält, wird auch eine Importbibliothek erstellt, es sei denn, bei der Erstellung wird eine EXP-Datei verwendet.
LINK verwendet die ergänzten Formen von Bezeichnern. Vom Compiler wird den Bezeichnern beim Erstellen der OBJ-Datei eine Ergänzung hinzugefügt. Wenn der Platzhalter entryname dem Linker in der nicht ergänzten Form (wie er im Quellcode angezeigt wird) angegeben wird, dann versucht LINK, den Namen zuzuordnen. Wenn keine eindeutige Übereinstimmung ermittelt werden kann, gibt LINK eine Fehlermeldung aus. Mit dem DUMPBIN-Tool können Sie die ergänzten Namen von Bezeichnern abrufen, wenn Sie diese dem Linker angeben müssen.
.gif "Hinweis") Hinweis: |
|---|
Geben Sie C-Bezeichner, die als __cdecl oder __stdcall deklariert wurden, ohne Namensergänzung an. |
So legen Sie diese Linkeroption in der Visual Studio-Entwicklungsumgebung fest
Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts. Ausführliche Informationen finden Sie unter Festlegen von Visual C++-Projekteigenschaften.
Klicken Sie auf den Ordner Linker.
Klicken Sie auf die Eigenschaftenseite für die Befehlszeile.
Geben Sie die Option im Feld Zusätzliche Optionen ein.
So legen Sie diese Linkeroption programmgesteuert fest
- Siehe AdditionalOptions.