/*** *crtexe.c - Initialization for console EXE using CRT DLL * * Copyright (c) 1991-2001, Microsoft Corporation. All rights reserved. * *Purpose: * This is the actual startup routine for apps linking to the CRT DLL. * It calls the user's main routine [w]main() or [w]WinMain after * performing C Run-Time Library initialization. * * With ifdefs, this source file also provides the source code for: * wcrtexe.c the startup routine for console apps with wide chars * crtexew.c the startup routine for Windows apps * wcrtexew.c the startup routine for Windows apps with wide chars * *Revision History: * 08-12-91 GJF Module created. * 01-05-92 GJF Substantially revised * 01-17-92 GJF Restored Stevewo's scheme for unhandled exceptions. * 01-29-92 GJF Added support for linked-in options (equivalents of * binmode.obj, commode.obj and setargv.obj). * 04-17-92 SKS Add call to _initterm() to do C++ constructors (I386) * 08-01-92 SRW winxcpt.h replaced bu excpt.h which is included by * oscalls.h * 09-16-92 SKS Prepare for C8 C++ for MIPS by calling C++ constructors * 04-02-93 SKS Change try/except to __try/__except * 04-06-93 SKS Replace _CRTAPI* with _cdecl * Change __GetMainArgs to __getmainargs * Change fmode/commode implementation to reflect the * the change to _declspec(dllimport) for imported data. * 04-12-93 CFW Added xia..xiz initializers and initializer call. * 04-26-93 GJF Made lpszCommandLine (unsigned char *) to deal with * chars > 127 in the command line. * 04-27-93 GJF Removed support for _RT_STACK, _RT_INTDIV, * _RT_INVALDISP and _RT_NONCONT. * 05-14-93 GJF Added support for quoted program names. * 05-24-93 SKS Add support for special versions of _onexit/atexit * which do one thing for EXE's and another for DLLs. * 10-19-93 CFW MIPS support for _imp__xxx. * 10-21-93 GJF Added support for NT's crtdll.dll. * 11-08-93 GJF Guard the initialization code with the __try - * __except statement (esp., C++ constructors for static * objects). * 11-09-93 GJF Replaced PF with _PVFV (defined in internal.h). * 11-23-93 CFW Wide char enable. * 12-07-93 CFW Change _TCHAR to _TSCHAR. * 01-04-94 CFW Pass copy of environment to main. * 01-11-94 GJF Call __GetMainArgs instead of __getmainargs for NT * SDK build (same function, different name) * 01-28-94 CFW Move environment copying to setenv.c. * 03-04-94 SKS Remove __setargv from this module to avoid link-time * problems compiling -MD and linking with setargv.obj. * static _dowildcard becomes an extern. Add another * parameter to _*getmainargs (_newmode). * NOTE: These channges do NOT apply to the _NTSDK. * 03-28-94 SKS Add call to _setdefaultprecision for X86 (not _NTSDK) * 04-01-94 GJF Moved declaration of __[w]initenv to internal.h. * 04-06-94 GJF _IMP___FMODE, _IMP___COMMODE now evaluate to * dereferences of function returns for _M_IX86 (for * compatability with Win32s version of msvcrt*.dll). * 04-25-94 CFW wWinMain has Unicode args. * 05-16-94 SKS Get StartupInfo to give correct nCmdShow parameter * to (_w)WinMain() (was ALWAYS passing SW_SHOWDEFAULT). * 08-04-94 GJF Added support for user-supplied _matherr routine * 09-06-94 GJF Added code to set __app_type properly. * 10-04-94 BWT Fix _NTSDK build * 02-22-95 JWM Spliced in PMAC code. * 05-24-95 CFW Official ANSI C++ new handler added. * 07-24-95 CFW Change PMac onexit malloc to _malloc_crt. * 06-27-96 GJF Replaced defined(_WIN32) wint !defined(_MAC). Cleaned * up the format a bit. * 08-01-96 RDK For PMac, set onexit table pointers to -1 to parallel * x86 functionality. * 04-28-99 PML Wrap __declspec(allocate()) in _CRTALLOC macro. * 05-11-99 KBF Wrap RTC support in #ifdef. * 05-17-99 PML Remove all Macintosh support. * 11-13-99 PML Create 4 new COM+ specific entrypoints which return * instead of calling exit(). * 11-16-99 PML ... and remove them - linker problems mean new * entrypoints don't work. Instead, look directly at the * COM Descriptor Image Directory entry in the optional * header to see if we are a COM+ app. * 02-16-00 GB Changed GetModuleHandle to GetModuleHandleA in * check_complus_app. * 08-04-00 PML check_complus_app -> check_managed_app (VS7#117746). * 08-22-00 GB Changed GetModuleHandle to GetModuleHandleA in * mainCRTStartup(). * 12-09-00 PML Tighten up check_managed_app tests (VS7#167293). * 03-27-01 PML report _RT_SPACEARG on __[w]getmainargs error * (VS7#231220). * 04-30-01 BWT Don't do this for SYSCRT. Need to run against old msvcrt.dll's * that don't return error. * Remove _NTSDK. * *******************************************************************************/ #ifdef CRTDLL /* * SPECIAL BUILD MACROS! Note that crtexe.c (and crtexew.c) is linked in with * the client's code. It does not go into crtdll.dll! Therefore, it must be * built under the _DLL switch (like user code) and CRTDLL must be undefined. * The symbol SPECIAL_CRTEXE is turned on to suppress the normal CRT DLL * definition of _fmode and _commode using __declspec(dllexport). Otherwise * this module would not be able to refer to both the local and DLL versions * of these two variables. */ #undef CRTDLL #undef _DLL #define _DLL #define SPECIAL_CRTEXE #include #include #include #include #include #include #include #include #include #include /* * wWinMain is not yet defined in winbase.h. When it is, this should be * removed. */ int WINAPI wWinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPWSTR lpCmdLine, int nShowCmd ); #define SPACECHAR _T(' ') #define DQUOTECHAR _T('\"') #ifdef _M_IX86 /* * The local copy of the Pentium FDIV adjustment flag * and the address of the flag in MSVCRT*.DLL. */ extern int _adjust_fdiv; extern int * _imp___adjust_fdiv; #endif /* default floating point precision - X86 only! */ #ifdef _M_IX86 extern void _setdefaultprecision(); #endif /* * Declare function used to install a user-supplied _matherr routine. */ _CRTIMP void __setusermatherr( int (__cdecl *)(struct _exception *) ); /* * Declare the names of the exports corresponding to _fmode and _commode */ #ifdef _M_IX86 #define _IMP___FMODE (__p__fmode()) #define _IMP___COMMODE (__p__commode()) #else /* ndef _M_IX86 */ /* assumed to be MIPS or Alpha */ #define _IMP___FMODE __imp__fmode #define _IMP___COMMODE __imp__commode #endif /* _M_IX86 */ #if !defined(_M_IX86) extern int * _IMP___FMODE; /* exported from the CRT DLL */ extern int * _IMP___COMMODE; /* these names are implementation-specific */ #endif extern int _fmode; /* must match the definition in */ extern int _commode; /* must match the definition in */ extern int _dowildcard; /* passed to __getmainargs() */ /* * Declare/define communal that serves as indicator the default matherr * routine is being used. */ int __defaultmatherr; /* * routine in DLL to do initialization (in this case, C++ constructors) */ extern void __cdecl _initterm(_PVFV *, _PVFV *); /* * routine to check if this is a managed application */ static int __cdecl check_managed_app(void); /* * pointers to initialization sections */ extern _CRTALLOC(".CRT$XIA") _PVFV __xi_a[]; extern _CRTALLOC(".CRT$XIZ") _PVFV __xi_z[]; /* C initializers */ extern _CRTALLOC(".CRT$XCA") _PVFV __xc_a[]; extern _CRTALLOC(".CRT$XCZ") _PVFV __xc_z[]; /* C++ initializers */ /* * Pointers to beginning and end of the table of function pointers manipulated * by _onexit()/atexit(). The atexit/_onexit code is shared for both EXE's and * DLL's but different behavior is required. These values are set to -1 to * mark this module as an EXE. */ extern _PVFV *__onexitbegin; extern _PVFV *__onexitend; /*** *mainCRTStartup(void) *wmainCRTStartup(void) *WinMainCRTStartup(void) *wWinMainCRTStartup(void) * *Purpose: * These routines do the C runtime initialization, call the appropriate * user entry function, and handle termination cleanup. For a managed * app, they then return the exit code back to the calling routine, which * is the managed startup code. For an unmanaged app, they call exit and * never return. * * Function: User entry called: * mainCRTStartup main * wmainCRTStartup wmain * WinMainCRTStartup WinMain * wWinMainCRTStartup wWinMain * *Entry: * *Exit: * Managed app: return value from main() et al, or the exception code if * execution was terminated by the __except guarding the call * to main(). * Unmanaged app: never return. * *******************************************************************************/ #ifdef _WINMAIN_ #ifdef WPRFLAG int wWinMainCRTStartup( #else int WinMainCRTStartup( #endif #else /* ndef _WINMAIN_ */ #ifdef WPRFLAG int wmainCRTStartup( #else int mainCRTStartup( #endif #endif /* _WINMAIN_ */ void ) { int argc; /* three standard arguments to main */ _TSCHAR **argv; _TSCHAR **envp; int argret; int mainret; int managedapp; #ifdef _WINMAIN_ _TUCHAR *lpszCommandLine; STARTUPINFO StartupInfo; #endif _startupinfo startinfo; /* * Determine if this is a managed application */ managedapp = check_managed_app(); /* * Guard the initialization code and the call to user's main, or * WinMain, function in a __try/__except statement. */ __try { /* * Set __app_type properly */ #ifdef _WINMAIN_ __set_app_type(_GUI_APP); #else __set_app_type(_CONSOLE_APP); #endif /* * Mark this module as an EXE file so that atexit/_onexit * will do the right thing when called, including for C++ * d-tors. */ __onexitbegin = __onexitend = (_PVFV *)(-1); /* * Propogate the _fmode and _commode variables to the DLL */ *_IMP___FMODE = _fmode; *_IMP___COMMODE = _commode; #ifdef _M_IX86 /* * Set the local copy of the Pentium FDIV adjustment flag */ _adjust_fdiv = * _imp___adjust_fdiv; #endif /* * Run the RTC initialization code for this DLL */ #ifdef _RTC _RTC_Initialize(); #endif /* * Call _setargv(), which will trigger a call to __setargv() if * SETARGV.OBJ is linked with the EXE. If SETARGV.OBJ is not * linked with the EXE, a dummy _setargv() will be called. */ #ifdef WPRFLAG _wsetargv(); #else _setargv(); #endif /* * If the user has supplied a _matherr routine then set * __pusermatherr to point to it. */ if ( !__defaultmatherr ) __setusermatherr(_matherr); #ifdef _M_IX86 _setdefaultprecision(); #endif /* * Do runtime startup initializers. * * Note: the only possible entry we'll be executing here is for * __lconv_init, pulled in from charmax.obj only if the EXE was * compiled with -J. All other .CRT$XI* initializers are only * run as part of the CRT itself, and so for the CRT DLL model * are not found in the EXE. For that reason, we call _initterm, * not _initterm_e, because __lconv_init will never return failure, * and _initterm_e is not exported from the CRT DLL. * * Note further that, when using the CRT DLL, executing the * .CRT$XI* initializers is only done for an EXE, not for a DLL * using the CRT DLL. That is to make sure the -J setting for * the EXE is not overriden by that of any DLL. */ _initterm( __xi_a, __xi_z ); #ifdef _RTC atexit(_RTC_Terminate); #endif /* * Get the arguments for the call to main. Note this must be * done explicitly, rather than as part of the dll's * initialization, to implement optional expansion of wild * card chars in filename args */ startinfo.newmode = _newmode; #ifdef ANSI_NEW_HANDLER startinfo.newh = _defnewh; #endif /* ANSI_NEW_HANDLER */ #ifdef WPRFLAG argret = __wgetmainargs(&argc, &argv, &envp, _dowildcard, &startinfo); #else argret = __getmainargs(&argc, &argv, &envp, _dowildcard, &startinfo); #endif #ifndef _SYSCRT if (argret < 0) _amsg_exit(_RT_SPACEARG); #endif /* * do C++ constructors (initializers) specific to this EXE */ _initterm( __xc_a, __xc_z ); #ifdef _WINMAIN_ /* * Skip past program name (first token in command line). * Check for and handle quoted program name. */ #ifdef WPRFLAG /* OS may not support "W" flavors */ if (_wcmdln == NULL) return 255; lpszCommandLine = (wchar_t *)_wcmdln; #else lpszCommandLine = (unsigned char *)_acmdln; #endif if ( *lpszCommandLine == DQUOTECHAR ) { /* * Scan, and skip over, subsequent characters until * another double-quote or a null is encountered. */ while ( *++lpszCommandLine && (*lpszCommandLine != DQUOTECHAR) ); /* * If we stopped on a double-quote (usual case), skip * over it. */ if ( *lpszCommandLine == DQUOTECHAR ) lpszCommandLine++; } else { while (*lpszCommandLine > SPACECHAR) lpszCommandLine++; } /* * Skip past any white space preceeding the second token. */ while (*lpszCommandLine && (*lpszCommandLine <= SPACECHAR)) { lpszCommandLine++; } StartupInfo.dwFlags = 0; GetStartupInfo( &StartupInfo ); #ifdef WPRFLAG mainret = wWinMain( #else mainret = WinMain( #endif GetModuleHandleA(NULL), NULL, lpszCommandLine, StartupInfo.dwFlags & STARTF_USESHOWWINDOW ? StartupInfo.wShowWindow : SW_SHOWDEFAULT ); #else /* _WINMAIN_ */ #ifdef WPRFLAG __winitenv = envp; mainret = wmain(argc, argv, envp); #else __initenv = envp; mainret = main(argc, argv, envp); #endif #endif /* _WINMAIN_ */ if ( !managedapp ) exit(mainret); _cexit(); } __except ( _XcptFilter(GetExceptionCode(), GetExceptionInformation()) ) { /* * Should never reach here */ mainret = GetExceptionCode(); if ( !managedapp ) _exit(mainret); _c_exit(); } /* end of try - except */ return mainret; } /*** *check_managed_app() - Check for a managed executable * *Purpose: * Determine if the EXE the startup code is linked into is a managed app * by looking for the COM Runtime Descriptor in the Image Data Directory * of the PE or PE+ header. * *Entry: * None * *Exit: * 1 if managed app, 0 if not. * *Exceptions: * *******************************************************************************/ static int __cdecl check_managed_app ( void ) { PIMAGE_DOS_HEADER pDOSHeader; PIMAGE_NT_HEADERS pPEHeader; PIMAGE_OPTIONAL_HEADER32 pNTHeader32; PIMAGE_OPTIONAL_HEADER64 pNTHeader64; pDOSHeader = (PIMAGE_DOS_HEADER)GetModuleHandleA(NULL); if ( pDOSHeader->e_magic != IMAGE_DOS_SIGNATURE ) return 0; pPEHeader = (PIMAGE_NT_HEADERS)((char *)pDOSHeader + pDOSHeader->e_lfanew); if ( pPEHeader->Signature != IMAGE_NT_SIGNATURE ) return 0; pNTHeader32 = (PIMAGE_OPTIONAL_HEADER32)&pPEHeader->OptionalHeader; switch ( pNTHeader32->Magic ) { case IMAGE_NT_OPTIONAL_HDR32_MAGIC: /* PE header */ if ( pNTHeader32->NumberOfRvaAndSizes <= IMAGE_DIRECTORY_ENTRY_COM_DESCRIPTOR ) return 0; return !! pNTHeader32 -> DataDirectory[IMAGE_DIRECTORY_ENTRY_COM_DESCRIPTOR] . VirtualAddress; case IMAGE_NT_OPTIONAL_HDR64_MAGIC: /* PE+ header */ pNTHeader64 = (PIMAGE_OPTIONAL_HEADER64)pNTHeader32; if ( pNTHeader64->NumberOfRvaAndSizes <= IMAGE_DIRECTORY_ENTRY_COM_DESCRIPTOR ) return 0; return !! pNTHeader64 -> DataDirectory[IMAGE_DIRECTORY_ENTRY_COM_DESCRIPTOR] . VirtualAddress; } /* Not PE or PE+, so not managed */ return 0; } #endif /* CRTDLL */