Функция 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.
Смотрите также:
CloseHandle, CreateProcess,
GetHandleInformation