Отправляет email-рассылки с помощью сервиса Sendsay

WinAPI на русском

  Все выпуски  

WinAPI на русском


Информационный Канал Subscribe.Ru

Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".

Сайт рассылки: http://www.bcbdev.ru. Материалы по Win32 API, C++Builder.

Раздел "WinAPI": http://www.bcbdev.ru/winapi.htm
Раздел "C++Builder": http://www.bcbdev.ru/cbuilder.htm
Раздел "Примеры кода": http://www.bcbdev.ru/codesamples.htm
Раздел "MSDN по-русски": http://www.bcbdev.ru/msdn/index.php

Обновления на сайте

В раздел C++Builder добавилась статья "Работа с USB-джойстиками. Версия 1.0".

Перевод

Сегодня вашему вниманию представлен перевод функции CreateConsoleScreenBuffer.

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

HANDLE CreateConsoleScreenBuffer(
  DWORD dwDesiredAccess,                            // флажок доступа
  DWORD dwShareMode,                                // режим совместного использования
буфера
  CONST LPSECURITY_ATTRIBUTES lpSecurityAttributes, // SD (указатель атрибутов
безопасности)
  DWORD dwFlags,                                    // тип буфера
  LPVOID lpScreenBufferData                         // зарезервировано
);
Параметры
dwDesiredAccess 
[in] Определяет доступ к экранному буферу консоли. Этот параметр может быть одно
или несколько нижеследующих значений. Значение Предназначение 
GENERIC_READ Запрашивает доступ для чтения в экранном буфере консоли, включая
процесс, чтобы читать данные из буфера. 
GENERIC_WRITE Запрашивает доступ для записи в экранном буфере консоли, включая
процесс, чтобы записать данные в буфер. 
За большей информацией обратитесь к статье Защита буфера и права доступа в консоли


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

FILE_SHARE_READ Другие операции открытия могут быть выполнены на экранном буфере
консоли для доступа к чтению. 
FILE_SHARE_WRITE Другие операции открытия могут быть выполнены на экранном буфере
консоли для доступа к записи. . 

  
lpSecurityAttributes 
[in] Указатель на структуру SECURITY_ATTRIBUTES, которая выясняет, может ли возвращенный
дескриптор быть унаследован дочерними процессами. Если lpSecurityAttributes имеет
значение NULL, дескриптор не может быть унаследован. 
Windows NT/2000/XP: член lpSecurityDescriptor структуры устанавливает дескриптор
защиты для нового экранного буфера консоли. Если lpSecurityAttributes имеет значение
NULL, экранный буфер консоли получает заданный по умолчанию дескриптор защиты.
ACLы в заданном по умолчанию дескрипторе защиты для экранного буфера консоли
исходят из того, первичный или заимствованный маркер прав создателя

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

dwFlags 
[in] Определяет тип создаваемого экранного буфера консоли. Единственный поддерживаемый
тип экранного буфера является CONSOLE_TEXTMODE_BUFFER. 
lpScreenBufferData 
[in] Зарезервирован; должен быть NULL. 
Возвращаемое значение
Если функция завершается успешно, возвращаемое значение является дескриптор нового
экранного буфера консоли. .

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


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

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

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

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

Требования 
  Windows NT/2000 или более поздняя версия: Требуется Windows NT 3.1 или новее.
  Windows 95/98/Me: Требуется Windows 95 или новее.
  Заголовочный файл: Определено в Wincon.h; Подключать Windows.h.
  Библиотека: Использовать Kernel32.lib.

Смотри также:
CloseHandle, DuplicateHandle, GetConsoleScreenBufferInfo, SECURITY_ATTRIBUTES,
SetConsoleActiveScreenBuffer, SetConsoleScreenBufferSize 

Справочник по WinAPI: http://www.bcbdev.ru/winapi/win32api.exe
Справочник по WinAPI (zip-версия): http://www.bcbdev.ru/winapi/win32api.zip
Дружественная рассылка "Программирование на WinAPI": http://subscribe.ru/catalog/comp.soft.prog.russianmsdn

С уважением, 
ведущий рассылки
Тарас Сорока.
mailto:tnsoroka@ua.fm

http://subscribe.ru/
http://subscribe.ru/feedback/
Подписан адрес:
Код этой рассылки: comp.soft.prog.winapi19743
Отписаться

В избранное