/ENTRY (Symbole de point d'entrée)
Mise à jour : novembre 2007
/ENTRY:function
Notes
où :
- function
désigne une fonction spécifiant l'adresse de départ définie par l'utilisateur d'un fichier .exe ou d'une DLL.
Notes
L'option /ENTRY spécifie une fonction de point d'entrée comme adresse de départ d'un fichier .exe ou d'une DLL.
La fonction doit être définie suivant la convention d'appel __stdcall. Les paramètres et la valeur de retour doivent être définis selon les spécifications données dans l'API Win32 de WinMain (pour un fichier .exe) ou de DllEntryPoint (pour une DLL). Il est recommandé de laisser l'éditeur de liens définir le point d'entrée pour que la bibliothèque Runtime C soit initialisée correctement et que les constructeurs C++ d'objets statiques soient exécutés.
Par défaut, l'adresse de départ est un nom de fonction issu de la bibliothèque Runtime C. L'éditeur de liens la sélectionne d'après les attributs du programme, comme indiqué dans le tableau suivant.
Nom de la fonction |
Par défaut |
---|---|
mainCRTStartup (ou wmainCRTStartup) |
Une application utilisant /SUBSYSTEM:CONSOLE ; appelle la fonction main (ou wmain). |
WinMainCRTStartup (ou wWinMainCRTStartup) |
Une application utilisant /SUBSYSTEM:WINDOWS ; appelle la fonction WinMain (ou wWinMain), qui doit être définie avec __stdcall |
_DllMainCRTStartup |
Une DLL ; appelle la fonction DllMain, qui doit être définie avec __stdcall, si elle existe. |
Si l'option /DLL ou /SUBSYSTEM n'est pas spécifiée, l'éditeur de liens sélectionne un sous-système et un point d'entrée selon que main ou WinMain est défini.
Les fonctions main, WinMain et DllMain sont les trois formes du point d'entrée défini par l'utilisateur.
Lors de la création d'une image managée, la fonction spécifiée avec /ENTRY doit avoir une signature de (LPVOID var1, DWORD var2, LPVOID var3).
Pour plus d'informations sur la définition de votre propre point d'entrée DllMain, consultez Comportement de la bibliothèque runtime.
Pour définir cette option de l'éditeur de liens dans l'environnement de développement Visual Studio
Ouvrez la boîte de dialogue Pages de propriété du projet. Pour plus d'informations, consultez Définition des propriétés de projets Visual C++.
Cliquez sur le dossier Éditeur de liens.
Cliquez sur la page de propriétés Avancé.
Modifiez la propriété Point d'entrée.
Pour définir cette option de l'éditeur de liens par programme
- Consultez EntryPointSymbol.