ExitWindowsExec

3.0

	BOOL ExitWindowsExec(lpszExe, lpszParams)
	LPCSTR lpszExe;
	LPCSTR lpszParams;

The ExitWindowsExec function terminates Windows, runs a specified MS-DOS application, and then restarts Windows.

Parameters

lpszExe

Points to a null-terminated string specifying the path and filename of the executable file for the system to run after Windows has been terminated. This string must not be longer than 128 bytes (including the null terminating character).

lpszParams

Points to a null-terminated string specifying any parameters for the executable file specified by the lpszExe parameter. This string must not be longer than 127 bytes (including the null terminating character). This value can be NULL.

Return Value

The return value is FALSE if the function fails. (The function could fail because of a memory-allocation error or if one of the applications in the system does not terminate.)

Comments

The ExitWindowsExec function is typically used by installation programs to replace components of Windows which are active when Windows is running.