Función UserHandleGrantAccess (winuser.h)

Artículo
08/28/2023

Concede o deniega el acceso a un identificador a un objeto User a un trabajo que tenga una restricción de interfaz de usuario. Cuando se concede acceso, todos los procesos asociados al trabajo pueden reconocer y usar posteriormente el identificador. Cuando se deniega el acceso, los procesos ya no pueden usar el identificador. Para obtener más información, vea Objetos de usuario.

Sintaxis

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

Parámetros

[in] hUserHandle

Identificador del objeto User.

[in] hJob

Identificador del trabajo al que se va a conceder acceso al identificador de usuario. La función CreateJobObject o OpenJobObject devuelve este identificador.

[in] bGrant

Si este parámetro es TRUE, todos los procesos asociados al trabajo pueden reconocer y usar el identificador. Si el parámetro es FALSE, los procesos no pueden usar el identificador .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Solo se puede llamar a la función UserHandleGrantAccess desde un proceso no asociado al trabajo especificado por el parámetro hJob . El identificador de usuario no debe ser propiedad de un proceso o subproceso asociado al trabajo.

Para crear restricciones de interfaz de usuario, llame a la función SetInformationJobObject con la clase de información del trabajo JobObjectBasicUIRestrictions.

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll