SetConsoleActiveScreenBuffer

	BOOL SetConsoleActiveScreenBuffer(hConsoleOutput)
	HANDLE hConsoleOutput;	/* screen buffer to be displayed	*/

The SetConsoleActiveScreenBuffer function sets the specified screen buffer to be the currently displayed console screen buffer.

Parameters

hConsoleOutput

Specifies an open screen buffer handle that becomes the currently displayed screen buffer.

Return Value

The return value is TRUE if the function was successful, or FALSE if an error occurred. Use the GetLastError function to obtain extended error information.

Comments

A console can have multiple screen buffers, and this function allows you to determine which one is displayed. It is possible to write to an inactive screen buffer, and then use SetConsoleActiveScreenBuffer to display its contents.