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

Статья
08/24/2023

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

Синтаксис

BOOL GetHandleInformation(
  [in]  HANDLE  hObject,
  [out] LPDWORD lpdwFlags
);

Параметры

[in] hObject

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

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

[out] lpdwFlags

Указатель на переменную, получающую набор битовых флагов, определяющих свойства дескриптора объекта или 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

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

SetHandleInformation