Функция UserHandleGrantAccess (winuser.h)

  • Статья

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

Синтаксис

BOOL UserHandleGrantAccess(
  [in] HANDLE hUserHandle,
  [in] HANDLE hJob,
  [in] BOOL   bGrant
);

Параметры

[in] hUserHandle

Дескриптор объекта User.

[in] hJob

Дескриптор задания, которому будет предоставлен доступ к дескриптору User. Функция CreateJobObject или OpenJobObject возвращает этот дескриптор.

[in] bGrant

Если этот параметр имеет значение TRUE, все процессы, связанные с заданием, могут распознавать и использовать дескриптор. Если параметр имеет значение FALSE, процессы не могут использовать дескриптор.

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

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

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

Комментарии

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

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

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll

См. также раздел

CreateJobObject

Объекты заданий

OpenJobObject

Функции процессов и потоков

SetInformationJobObject