Compartilhar via


Função UserHandleGrantAccess (winuser.h)

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

Confira também

CreateJobObject

Objetos de trabalho

OpenJobObject

Funções de thread e processo

SetInformationJobObject