EXPORTS
Introduce una sezione di una o più definizioni di esportazione che specificano i nomi o gli ordinali esportati di funzioni o dati. Ogni definizione deve essere riportata in una riga separata.
EXPORTS
definition
Note
La prima definition può trovarsi nella stessa riga della parola chiave EXPORTS o in una riga successiva. Il file con estensione DEF può contenere una o più istruzioni EXPORTS.
La sintassi di una definition di esportazione è la seguente:
entryname[=internalname] [@ordinal [NONAME]] [[PRIVATE] | [DATA]]
entryname è il nome di funzione o variabile che si vuole esportare ed è obbligatorio. Se il nome da esportare è diverso dal nome nella DLL, specificare il nome dell'esportazione nella DLL usando internalname. Se ad esempio la DLL esporta una funzione func1 e si vuole che i chiamanti la usino come func2, specificare:
EXPORTS
func2=func1
Dato che il compilatore di Visual C++ usa la decorazione dei nomi per le funzioni C++, è necessario usare il nome decorato come entryname o internalname oppure definire le funzioni esportate usando extern "C" nel codice sorgente. Il compilatore decora anche le funzioni C che usano la convenzione di chiamata __stdcall con un carattere di sottolineatura (_) come prefisso e un suffisso composto da una chiocciola (@) seguita dal numero di byte (in decimale) nell'elenco degli argomenti.
Per trovare i nomi decorati creati dal compilatore, usare lo strumento DUMPBIN o l'opzione del linker /MAP. I nomi decorati sono specifici del compilatore. Se si esportano i nomi decorati nel file .DEF, gli eseguibili che si collegano alla DLL devono essere anch'essi compilati usando la stessa versione del compilatore. Questo garantisce che i nomi decorati nel chiamante corrispondano ai nomi esportati nel file .DEF.
È possibile usare @ordinal per specificare l'inserimento di un numero, invece del nome della funzione, nella tabella di esportazione della DLL. Molte DLL Windows esportano ordinali per supportare il codice legacy. In precedenza, era pratica comune usare ordinali nel codice Windows a 16 bit, perché ciò può aiutare a ridurre le dimensioni di una DLL. Si sconsiglia di esportare funzioni in base a ordinali a meno che i destinatari della DLL non necessitino di tale funzione a scopo di supporto della legacy. Dato che il file .LIB file conterrà il mapping tra l'ordinale e la funzione, è possibile usare il nome della funzione come si farebbe normalmente nei progetti che usano la DLL.
Usando la parola chiave facoltativa NONAME, è possibile esportare solo per ordinali riducendo la dimensione della tabella di esportazione nella DLL risultante. Se si vuole usare GetProcAddress nella DLL, tuttavia, è necessario conoscere l'ordinale perché il nome non sarà valido.
La parola chiave facoltativa PRIVATE impedisce l'inclusione di entryname nella libreria di importazione generata da LINK. Questa non ha alcun effetto sull'esportazione nell'immagine, anch'essa generata da LINK.
La parola chiave facoltativa DATA specifica che un'esportazione consiste in dati e non in codice. L'esempio seguente illustra come esportare una variabile dati denominata exported_global:
EXPORTS
exported_global DATA
Vi sono quattro metodi per esportare una definizione, elencati di seguito in ordine di preferenza.
La parola chiave __declspec(dllexport) nel codice sorgente
Un'istruzione EXPORTS in un file .DEF
Una specifica /EXPORT in un comando LINK
Una direttiva comment nel codice sorgente, del formato #pragma comment(linker, "/export:definition")
Tutti e quattro i metodi possono essere usati nello stesso programma. Quando LINK compila un programma che contiene esportazioni, crea anche una libreria di importazione, a meno che non venga usato un file .EXP nella compilazione.
Di seguito è riportato un esempio di sezione EXPORTS:
EXPORTS
DllCanUnloadNow @1 PRIVATE
DllWindowName = WindowName DATA
DllGetClassObject @4 NONAME PRIVATE
DllRegisterServer @7
DllUnregisterServer
Quando si esporta una variabile da una DLL usando un file .DEF, non è necessario specificare __declspec(dllexport) nella variabile. In qualsiasi file che usa la DLL, tuttavia, è comunque necessario usare __declspec(dllimport) nella dichiarazione dei dati.