Функция GetHandleInformation


Функция GetHandleInformation извлекает некоторые свойства дескриптора объекта.

Синтаксис

BOOL GetHandleInformation(

HANDLE hObject,    // дескриптор объекта
LPDWORD lpdwFlags  // свойства дескриптора
); 

Параметры

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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz