Функция
GetHandleInformationФункция
GetHandleInformation извлекает некоторые свойства дескриптора объекта.
hObject, // дескриптор объекта LPDWORDlpdwFlags // свойства дескриптора ); |
hObject
[in] Дескриптор объекта, информация о котором должна быть извлечена.
Вы можете задать дескриптор одного из ниже перечисленных типов объектов: признак доступа, событие, файл, отображение файла в память, задание, почтовый слот, мьютекс (флажок блокировки). А также канал, принтер, процесс, ключ системного реестра, семафор, последовательное устройство связи, сокет, поток или ждущий таймер.
Windows 2000/XP: Этот параметр может также быть дескриптор буфера ввода консоли или экранного буфера консоли.
lpdwFlags
[out] Указатель на переменную, которая получает набор битовых флажков, которые устанавливают свойства дескриптора объекта. Устанавливаемые значения даны ниже.
Значение |
Предназначение |
HANDLE_FLAG_INHERIT |
Если этот флажок установлен, дочерний процесс, созданный функцией CreateProcess с параметром bInheritHandles установленным в значение ИСТИНА (TRUE) наследует дескриптор объекта. |
HANDLE_FLAG_PROTECT_FROM_CLOSE |
Если этот флажок установлен, вызов функции CloseHandle не будет закрывать дескриптор объекта. |
Если функция завершается успешно, величина возвращаемого значения - не ноль.
Если функция завершается с ошибкой, величина возвращаемого значения - ноль. Чтобы получать расширенные данные об ошибках, вызовите
GetLastError.Смотри также
Обзор Дескрипторы и объекты, Функции дескрипторов и объектов, CloseHandle, CreateFile, CreateProcess, SetHandleInformation
Размещение и совместимость GetHandleInformation |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да |
Windows Me |
Нет |
Windows 98 |
Нет |
Windows 95 |
Нет |
Используемая библиотека |
Kernel32.lib |
Заголовочный файл |
|
- объявлено в |
Winbase.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |