Функция UserHandleGrantAccess

Функция UserHandleGrantAccess предоставляет или отказывает в доступе к дескриптору Пользовательского объекта к заданию, которое имеет ограничение пользовательского интерфейса. Когда доступ предоставляется, все процессы, связанные с заданием могут впоследствии распознавать и использовать дескриптор. Когда доступ не дан, процессы больше не могут использовать дескриптор. Для получения дополнительной информации см. Пользовательские объекты.

Синтаксис

BOOL UserHandleGrantAccess(

HANDLE hUserHandle , // дескриптор пользовательского объекта
HANDLE
hJob ,        // дескриптор задания
BOOL
bGrant      // предоставление или отклонение доступа

);

Параметры

hUserHandle

[in] Дескриптор пользовательского объекта.

hJob

[in] Дескриптор задания, которому будет предоставлен доступ к дескриптору пользователя. Функция CreateJobObject или OpenJobObject возвращает значение этого дескриптора.

bGrant

[in] Если этот параметр - ИСТИНА (TRUE), все процессы, связанные с заданием могут распознавать и использовать дескриптор. Если параметр - ЛОЖЬ (FALSE), процессы не могут использовать дескриптор.

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

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

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

Замечания

Функция UserHandleGrantAccess может быть вызвана только из процесса, не связанного с заданием, указанным параметром hJob. Дескриптор пользователя не должен принадлежать процессу или потоку, связанному с заданием.

Чтобы создать ограничения пользовательского интерфейса, вызовите функцию SetInformationJobObject с классом информации задания JobObjectBasicUIRestrictions.

Смотри также

Краткий обзор Процессы и потоки, Функции, используемые процессами и потоками, CreateJobObject, OpenJobObject, SetInformationJobObject

Размещение и совместимость UserHandleGrantAccess

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