Export (0) Print
Expand All
Expand Minimize

UserHandleGrantAccess function

Grants or denies access to a handle to a User object to a job that has a user-interface restriction. When access is granted, all processes associated with the job can subsequently recognize and use the handle. When access is denied, the processes can no longer use the handle. For more information see User Objects.

Syntax


BOOL WINAPI UserHandleGrantAccess(
  _In_  HANDLE hUserHandle,
  _In_  HANDLE hJob,
  _In_  BOOL bGrant
);

Parameters

hUserHandle [in]

A handle to the User object.

hJob [in]

A handle to the job to be granted access to the User handle. The CreateJobObject or OpenJobObject function returns this handle.

bGrant [in]

If this parameter is TRUE, all processes associated with the job can recognize and use the handle. If the parameter is FALSE, the processes cannot use the handle.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The UserHandleGrantAccess function can be called only from a process not associated with the job specified by the hJob parameter. The User handle must not be owned by a process or thread associated with the job.

To create user-interface restrictions, call the SetInformationJobObject function with the JobObjectBasicUIRestrictions job information class.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

CreateJobObject
OpenJobObject
Job Objects
Process and Thread Functions
SetInformationJobObject

 

 

Community Additions

ADD
Show:
© 2014 Microsoft