/ENTRY (Simbolo del punto di ingresso)
Aggiornamento: novembre 2007
/ENTRY:function
Note
Dove:
- function
Funzione che specifica un indirizzo iniziale definito dall'utente per un file exe o per una DLL.
Note
L'opzione /ENTRY consente di specificare una funzione del punto di ingresso come indirizzo iniziale di un file exe o di una DLL.
È necessario che la funzione venga definita con la convenzione di chiamata __stdcall e che i parametri e il valore restituito vengano definiti come documentato nell'API Win32 per WinMain (nel caso di un file exe) o DllEntryPoint (nel caso di una DLL). Si consiglia di consentire l'impostazione del punto d'ingresso nel linker in modo da garantire la corretta inizializzazione della libreria di runtime del linguaggio C e l'esecuzione dei costruttori C++ per gli oggetti statici.
Per impostazione predefinita l'indirizzo iniziale è un nome di funzione tratto dalla libreria di runtime del linguaggio C. Tale indirizzo viene selezionato nel linker in base agli attributi del programma, come illustrato nella tabella che segue.
Nome funzione |
Impostazione predefinita per |
|---|---|
mainCRTStartup (o wmainCRTStartup) |
Un'applicazione in cui viene utilizzata /SUBSYSTEM:CONSOLE. Chiama main (o wmain). |
WinMainCRTStartup (o wWinMainCRTStartup) |
Un'applicazione in cui viene utilizzata /SUBSYSTEM:WINDOWS. Chiama WinMain (o wWinMain), da definire con __stdcall. |
_DllMainCRTStartup |
Una DLL. Chiama DllMain, da definire con __stdcall, se presente. |
Se l'opzione /DLL o /SUBSYSTEM non è specificata, verranno automaticamente selezionati un sottosistema e un punto di ingresso, a seconda che sia definita la funzione main o WinMain.
Le funzioni main, WinMain e DllMain rappresentano le tre forme del punto di ingresso definito dall'utente.
Quando si crea un'immagine gestita, la funzione specificata con /ENTRY deve disporre di una firma di (LPVOID var1, DWORD var2, LPVOID var3).
Per informazioni su come definire un punto di ingresso DllMain, vedere Funzionamento della libreria di runtime.
Per impostare l'opzione del linker nell'ambiente di sviluppo di Visual Studio
Aprire la finestra di dialogo Pagine delle proprietà del progetto. Per informazioni dettagliate, vedere Impostazione delle proprietà dei progetti Visual C++.
Selezionare la cartella Linker.
Fare clic sulla pagina delle proprietà Avanzate.
Modificare la proprietà Punto di ingresso.
Per impostare l'opzione del linker a livello di codice
- Vedere EntryPointSymbol.