Функция
SetHandleInformation устанавливает некоторые свойства дескриптора объекта.Синтаксис
hObject, // дескриптор объекта DWORD dwMask, // заменяемые флажки DWORD dwFlags // новые значения флажков );BOOL SetHandleInformation( HANDLE |
Параметры
hObject
[in] Дескриптор объекта, информация о котором должна быть установлена.
Вы можете задать дескриптор одного из ниже перечисленных типов объектов: признак доступа, событие, файл, отображение файла в память, задание, почтовый слот, мьютекс (флажок блокировки). А также канал, принтер, процесс, ключ системного реестра, семафор, последовательное устройство связи, сокет, поток или ждущий таймер.
Windows 2000/XP: Этот параметр может также быть дескриптором буфера ввода консоли или экранного буфера консоли.
dwMask
[in] Маска, которая устанавливает битовые флажки, которые будут заменены. Используйте те же самые константы, показанные в описании параметра
dwFlags.dwFlags
[in] Устанавливает биты флажков, которые задают свойства дескриптора объекта. Этот параметр может быть одним из нижеследующих значений.
Значение |
Предназначение |
HANDLE_FLAG_INHERIT |
Если этот флажок установлен, дочерний процесс, созданный функцией CreateProcess с параметром bInheritHandles установленным в значение ИСТИНА (TRUE) наследует дескриптор объекта. |
HANDLE_FLAG_PROTECT_FROM_CLOSE |
Если этот флажок установлен, вызов функции CloseHandle не будет закрывать дескриптор объекта. |
Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - не ноль.
Если функция завершается с ошибкой, величина возвращаемого значения - ноль. Чтобы получать расширенные данные об ошибках, вызовите
GetLastError.Чтобы установить или сбросить связанный битовый флажок в
dwFlags, Вы должны установить флажок бита маски замены в параметре dwMask.Смотри также
Обзор Дескрипторы и объекты, Функции дескрипторов и объектов, CloseHandle, CreateFile, CreateProcess, GetHandleInformation
Размещение и совместимость SetHandleInformation |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да |
Windows Me |
Нет |
Windows 98 |
Нет |
Windows 95 |
Нет |
Используемая библиотека |
Kernel32.lib |
Заголовочный файл |
|
- объявлено в |
Winbase.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |