Функция CreateConsoleScreenBuffer

Функция CreateConsoleScreenBuffer создает экранный буфер консоли.

HANDLE CreateConsoleScreenBuffer(

Определяет доступ к экранному буферу консоли. Этот параметр может быть одно или несколько нижеследующих значений.

За большей информацией обратитесь к статье Защита буфера и права доступа в консоли.

Определяет, как этот экранный буфер консоли может быть совместно использован. Этот параметр , может быть нулевой, указывая, что буфер не может совместно использоваться или он может иметь одно или несколько нижеследующих значений.

lpSecurityAttributes

Указатель на структуру SECURITY_ATTRIBUTES, которая выясняет, может ли возвращенный дескриптор быть унаследован дочерними процессами. Если lpSecurityAttributes имеет значение ПУСТО (NULL), дескриптор не может быть унаследован.

Windows NT/2000/XP: член lpSecurityDescriptor структуры устанавливает дескриптор защиты для нового экранного буфера консоли. Если lpSecurityAttributes имеет значение ПУСТО (NULL), экранный буфер консоли получает заданный по умолчанию дескриптор защиты. ACLы в заданном по умолчанию дескрипторе защиты для экранного буфера консоли исходят из того, первичный или заимствованный маркер прав создателя.

Windows 95: член lpSecurityDescriptor структуры игнорируется.

Определяет тип создаваемого экранного буфера консоли. Единственный поддерживаемый тип экранного буфера является CONSOLE_TEXTMODE_BUFFER.

Если функция завершается с ошибкой, возвращаемое значение - INVALID_HANDLE_VALUE. Чтобы получать расширенные данные об ошибках, обратитесь к функции GetLastError.

Замечания

Консоль может иметь многочисленные экранные буферы, но только один активный экранный буфер. К неактивным экранным буферам можно обращаться для чтения и записи, но только активный экранный буфер отображается на экране. Чтобы новый экранный буфер сделать активным, используйте функцию SetConsoleActiveScreenBuffer.

Вызывающий процесс может использовать возвращенный дескриптор в любой функции, которая требует дескриптора экранного буфера консоли, зависящего от ограничений доступа, определяемых параметром dwDesiredAccess.

Вызывающий процесс может использовать функцию DuplicateHandle, чтобы создать продублированный дескриптор экранного буфера, который имеет другой доступ или наследственность от первоначального дескриптора. Однако функция DuplicateHandle не может использоваться для создания дубликата, который является правильным для другого процесса (кроме как через наследование).

Чтобы закрыть дескриптор экранного буфера консоли, используйте функцию CloseHandle.

За примером кода обратитесь к статье Чтение и запись блоков символов и атрибутов.

Обзор консольных приложений, Функции консоли, CloseHandle, DuplicateHandle, GetConsoleScreenBufferInfo, SECURITY_ATTRIBUTES, SetConsoleActiveScreenBuffer, SetConsoleScreenBufferSize