Отправляет 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

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

Нет.

Перевод

Сегодня вашему вниманию представлен перевод функции 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


http://subscribe.ru/
E-mail: ask@subscribe.ru
Отписаться
Убрать рекламу

В избранное