Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "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
Обновления на сайте
Нет.
Перевод
Сегодня вашему вниманию представлен перевод функции SetHandleInformation.
SetHandleInformation
Функция SetHandleInformation устанавливает свойства дескриптора объекта.
BOOL SetHandleInformation(
HANDLE hObject, // дескриптор объекта
DWORD dwMask, // изменяемые флаги
DWORD dwFlags // новые значения для флагов
);
Параметры
hObject – дескриптор объекта, для которого изменяется информация.
Вы можете указать дескриптор для одного из следующих типов объектов: маркер доступа
(access token), событие (event), файл, отображаемый в память файл, задание печати,
мэйлслот, мьютекс, коммуникационный канал (pipe), процесс, ветвь реестра, семафор,
устройство последовательной связи (serial communication device), сокет, поток
или таймер ожидания (waitable timer).
Windows 2000/XP: значение этого параметра также может быть дескриптором буфера
ввода консоли или экранного буфера консоли.
dwMask – маска, которая определяет изменяемые битовые флаги. Используйте те же
константы, которые указаны в описании dwFlags.
dwFlags – набор битовых флагов, которые определяет свойства дескриптора объекта.
Может принимать одно из следующих значений:
Значение Пояснение
HANDLE_FLAG_INHERIT Если установлен этот флаг, то дочерний процесс, созданный
с параметром bInheritHandles функции CreateProcess, установленным в TRUE, унаследует
дескриптор объекта.
HANDLE_FLAG_PROTECT_FROM_CLOSE Если установлен этот флаг, то вызов функции CloseHandle
не закроет дескриптор объекта.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об
ошибке вызовите функцию GetLastError.
Комментарии
Для установки или снятия битового флага в dwFlags, вы должны установить маску
изменения битового флага в dwMask.
Требования
Windows NT/2000/XP: включена в Windows NT 3.51 и выше.
Windows 95/98/Me: не поддерживается.
Заголовок: объявлена в Winbase.h; подключать Windows.h.
Библиотека: используйте Kernel32.lib.
См. также
CreateProcess, CloseHandle, GetHandleInformation.
Справочник по 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:stathome@rol.ru