Função UserHandleGrantAccess (winuser.h)

Artigo
08/28/2023

Concede ou nega acesso a um identificador de um objeto User a um trabalho que tem uma restrição de interface do usuário. Quando o acesso é concedido, todos os processos associados ao trabalho podem reconhecer e usar o identificador posteriormente. Quando o acesso é negado, os processos não podem mais usar o identificador. Para obter mais informações, consulte Objetos de Usuário.

Sintaxe

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

Parâmetros

[in] hUserHandle

Um identificador para o objeto User.

[in] hJob

Um identificador para o trabalho a ser concedido acesso ao identificador de usuário. A função CreateJobObject ou OpenJobObject retorna esse identificador.

[in] bGrant

Se esse parâmetro for TRUE, todos os processos associados ao trabalho poderão reconhecer e usar o identificador. Se o parâmetro for FALSE, os processos não poderão usar o identificador.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função UserHandleGrantAccess só pode ser chamada de um processo não associado ao trabalho especificado pelo parâmetro hJob . O identificador de usuário não deve pertencer a um processo ou thread associado ao trabalho.

Para criar restrições de interface do usuário, chame a função SetInformationJobObject com a classe de informações de trabalho JobObjectBasicUIRestrictions.

Requisitos


Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll