Поделиться через


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

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

Синтаксис

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