Funzione SwitchDesktop (winuser.h)
Rende visibile il desktop specificato e lo attiva. In questo modo il desktop riceve l'input dall'utente. Il processo chiamante deve avere DESKTOP_SWITCHDESKTOP l'accesso al desktop affinché la funzione SwitchDesktop abbia esito positivo.
Sintassi
BOOL SwitchDesktop(
[in] HDESK hDesktop
);
Parametri
[in] hDesktop
Handle per il desktop. Questo handle viene restituito dalle funzioni CreateDesktop e OpenDesktop .
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. Tuttavia, SwitchDesktop imposta solo l'ultimo errore per i casi seguenti:
- Quando il desktop appartiene a una stazione finestra invisibile
- Quando hDesktop è un handle non valido, fa riferimento a un desktop eliminato o appartiene a una sessione diversa da quella del processo chiamante
Commenti
La funzione SwitchDesktop ha esito negativo se il desktop appartiene a una stazione finestra invisibile. SwitchDesktop ha esito negativo anche quando viene chiamato da un processo associato a un desktop protetto, ad esempio i desktop WinLogon e ScreenSaver. I processi associati a un desktop protetto includono processi UserInit personalizzati. Tali chiamate in genere hanno esito negativo con un errore di accesso negato.
Requisiti
| 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) |