Funzione SwitchDesktop (winuser.h)

  • Articolo

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)

Vedi anche

CreateDesktop

Desktop

OpenDesktop

Funzioni di windows e desktop