Microsoft KB Archive/99115

{|
 * width="100%"|

INFO: Preventing the Console Window from Disappearing

 * }

Q99115

-

The information in this article applies to:


 * Microsoft Win32 Application Programming Interface (API), used with:
 * the operating system: Microsoft Windows NT, versions 3.1, 3.5, 3.51, 4.0
 * the operating system: Microsoft Windows 2000

-

SUMMARY
When a console application is started either from the File Manager, the Program Manager, Windows NT Explorer, or by typing start  from the command prompt, it executes in its own console. This console disappears as soon as the application terminates, and therefore the user can't read anything written to the screen between the last pause and program exit. There are two approaches to keep the console window from disappearing.

Method 1: Pause if Process is Running in Separate Console
The first method is for implementing a console application to not terminate immediately when it is running in a separate console window. It is not likely that you would want an application to always pause after displaying information to the console window when you started from the prompt. However, there is no API (application programming interface) that directly determines whether or not the application shares a console with CMD.EXE. This method looks at the current location of the console cursor, and if it is (0,0), then the program assumes it is running in a separate console window.

Sample Code
  #include    #include    #include 

CONSOLE_SCREEN_BUFFER_INFO csbi; HANDLE hStdOutput; BOOL bUsePause;

void main(void) {     hStdOutput = GetStdHandle(STD_OUTPUT_HANDLE); if (!GetConsoleScreenBufferInfo(hStdOutput, &csbi)) {        printf(&quot;GetConsoleScreenBufferInfo failed: %d\n&quot;, GetLastError); return; }

// if cursor position is (0,0) then use pause bUsePause = ((!csbi.dwCursorPosition.X) &&                  (!csbi.dwCursorPosition.Y));

printf(&quot;Interesting information to read.\n&quot;); printf(&quot;More interesting information to read.\n&quot;);

// only pause if running in separate console window. if (bUsePause) {        int ch; printf(&quot;\n\tPress any key to exit...\n&quot;); ch = getch; }  } NOTE: This method will not work if the user combines a clear screen (CLS) and execution of the application into one step (for example, [C:\] CLS & ), because the cursor position will be (0, 0), but the application is using the console, which belongs to CMD.EXE.

Method 2: Start the console with cmd.exe /K
This method is for starting a console application in a separate window and forcing the window to remain after the application has terminated. An application can use the following command line with WinExec, CreateProcess, or in a batch file:

"cmd /K consoleapp.exe" After consoleapp.exe has terminated, the /K switch makes the console window remain on the screen. The application user can then type the exit command to close the console window.

Additional query words:

Keywords : kbprogramming kbConsole kbKernBase kbOSWinNT310 kbOSWinNT350 kbOSWinNT351 kbOSWinNT400 kbOSWin2000 kbDSupport kbGrpDSKernBase

Issue type : kbinfo

Technology : kbAudDeveloper kbWin32sSearch kbWin32API