Funzione SetThreadDesktop (winuser.h)

Articolo
03/13/2024

Assegna il desktop specificato al thread chiamante. Tutte le operazioni successive sul desktop usano i diritti di accesso concessi al desktop.

Sintassi

BOOL SetThreadDesktop(
  [in] HDESK hDesktop
);

Parametri

[in] hDesktop

Handle per il desktop da assegnare al thread chiamante. Questo handle viene restituito dalla funzione CreateDesktop, GetThreadDesktop, OpenDesktop o OpenInputDesktop .

Questo desktop deve essere associato alla stazione finestra corrente per il processo.

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 SetThreadDesktop avrà esito negativo se il thread chiamante ha finestre o hook sul desktop corrente, a meno che il parametro hDesktop non sia un handle per il desktop corrente.

Avviso Esiste un rischio significativo per la sicurezza per qualsiasi servizio che apre una finestra sul desktop interattivo. Aprendo una finestra desktop, un servizio si rende vulnerabile agli attacchi dell'utente connesso, la cui applicazione potrebbe inviare messaggi dannosi alla finestra desktop del servizio e influire sulla sua capacità di funzionare.

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-0 (introdotto in Windows 8)