Функция SetHandleInformation (handleapi.h)

  • Статья

Задает определенные свойства дескриптора объекта.

Синтаксис

BOOL SetHandleInformation(
  [in] HANDLE hObject,
  [in] DWORD  dwMask,
  [in] DWORD  dwFlags
);

Параметры

[in] hObject

Дескриптор объекта, сведения которого должны быть заданы.

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

[in] dwMask

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

[in] dwFlags

Набор битовых флагов, указывающих свойства дескриптора объекта. Этот параметр может иметь значение 0 или одно или несколько из следующих значений.

Значение Значение
HANDLE_FLAG_INHERIT
0x00000001
 Если этот флаг установлен, дочерний процесс, созданный с параметром bInheritHandlescreateProcess , который имеет значение TRUE , наследует дескриптор объекта.
HANDLE_FLAG_PROTECT_FROM_CLOSE
0x00000002
 Если этот флаг установлен, вызов функции CloseHandle не закроет дескриптор объекта.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

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

Комментарии

Чтобы задать или снять соответствующий битовый флаг в dwFlags, необходимо установить флаг бита маски изменений в dwMask.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header handleapi.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

CloseHandle

CreateProcess

GetHandleInformation

Функции дескрипторов и объектов