Функция SetHandleInformation устанавливает определенные свойства дескриптора объекта. Информация определяется как набор битовых флагов.

BOOL SetHandleInformation (
    HANDLE hObject,	// дескриптор объекта
    DWORD dwMask,	// определяет изменяемые флаги
    DWORD dwFlags	// задает новые значения флагов
);

Параметры:

hObject	Определяет дескриптор объекта. Функция SetHandleInformation устанавливает информацию, которая ассоциируется с этим дескриптором объекта.
dwMask	Маска, которая определяет изменяемые битовые флаги. Используйте те же флаги, которые указаные в описании dwFlags.
dwFlags	Набор битовых флагов, которые задают свойства дескриптора объекта. Это следующие флаги: Значение: Описание: HANDLE_FLAG_INHERIT Если этот флаг установлен, то дочерний процесс, созданный с установленным в TRUE параметром bInheritHandles (в CreateProcess), наследует дескриптор объекта. HANDLE_FLAG_PROTECT_FROM_CLOSE Если установлен этот флаг, вызов функции CloseHandle не закрывает дескриптор объекта.

Возвращаемые значения:

При успешном завершении, функция возвращает ненулевое значение.

При ошибке возвращается ноль. Для получения дополнительной информации об ошибке, вызовите GetLastError.

Замечания:

Учтите, что вы должны установить битовый флаг маски изменений в dwMask в порядке установки или очистки ассоциируемых битовых флагов в dwFlags.

Смотрите также: