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

Статья
08/24/2023

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

Синтаксис

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.

Требования


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

См. также

CloseHandle

CreateProcess

GetHandleInformation

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