Funzione OpenInputDesktop (winuser.h)

Articolo
08/27/2023

Apre il desktop che riceve l'input utente.

Sintassi

HDESK OpenInputDesktop(
  [in] DWORD       dwFlags,
  [in] BOOL        fInherit,
  [in] ACCESS_MASK dwDesiredAccess
);

Parametri

[in] dwFlags

Questo parametro può essere zero o il valore seguente.

Valore	Significato
DF_ALLOWOTHERACCOUNTHOOK 0x0001	Consente ai processi in esecuzione in altri account sul desktop di impostare i hook in questo processo.

[in] fInherit

Se questo valore è TRUE, i processi creati da questo processo erediteranno l'handle. In caso contrario, i processi non ereditano questo handle.

[in] dwDesiredAccess

Accesso al desktop. Per un elenco dei diritti di accesso, vedere Sicurezza desktop e diritti di accesso.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per il desktop che riceve l'input utente. Al termine dell'uso dell'handle, chiamare la funzione CloseDesktop per chiuderla.

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

Commenti

Il processo chiamante deve avere una stazione finestra associata, assegnata dal sistema quando il processo viene creato o impostato dalla funzione SetProcessWindowStation . La stazione finestra associata al processo chiamante deve essere in grado di ricevere l'input.

Se il processo chiamante è in esecuzione in una sessione disconnessa, la funzione restituisce un handle al desktop che diventa attivo quando l'utente ripristina la connessione.

Un'applicazione può usare la funzione SwitchDesktop per modificare il desktop di input.

Se il parametro dwDesiredAccessspecifica i diritti di accesso READ_CONTROL, WRITE_DAC o WRITE_OWNER diritti di accesso standard, è necessario richiedere anche i diritti di accesso DESKTOP_READOBJECTS e DESKTOP_WRITEOBJECTS .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-windowstation-l1-1-1 (introdotto in Windows 8.1)