Funzione UserHandleGrantAccess (winuser.h)

  • Articolo

Concede o nega l'accesso a un handle a un oggetto User a un processo con una restrizione dell'interfaccia utente. Quando viene concesso l'accesso, tutti i processi associati al processo possono successivamente riconoscere e usare l'handle. Quando l'accesso viene negato, i processi non possono più usare l'handle. Per altre informazioni, vedere Oggetti utente.

Sintassi

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

Parametri

[in] hUserHandle

Handle per l'oggetto User.

[in] hJob

Handle per il processo a cui concedere l'accesso all'handle utente. La funzione CreateJobObject o OpenJobObject restituisce questo handle.

[in] bGrant

Se questo parametro è TRUE, tutti i processi associati al processo possono riconoscere e usare l'handle. Se il parametro è FALSE, i processi non possono usare l'handle.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione UserHandleGrantAccess può essere chiamata solo da un processo non associato al processo specificato dal parametro hJob . L'handle utente non deve essere di proprietà di un processo o di un thread associato al processo.

Per creare restrizioni dell'interfaccia utente, chiamare la funzione SetInformationJobObject con la classe di informazioni sul processo JobObjectBasicUIRestrictions.

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winuser.h (include Windows.h)
Libreria User32.lib
DLL User32.dll

Vedi anche

CreateJobObject

Oggetti processo

OpenJobObject

Funzioni di processi e thread

SetInformationJobObject