Функция SetHandleInformation

Функция SetHandleInformation устанавливает некоторые свойства дескриптора объекта.

Синтаксис
BOOL SetHandleInformation(
  HANDLE hObject,  // дескриптор объекта
  DWORD dwMask,    // заменяемые флажки 
  DWORD dwFlags    // новые значения флажков
);

Параметры

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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz