Fungsi SwitchDesktop (winuser.h)

  • Artikel

Membuat desktop yang ditentukan terlihat dan mengaktifkannya. Ini memungkinkan desktop untuk menerima input dari pengguna. Proses panggilan harus memiliki akses DESKTOP_SWITCHDESKTOP ke desktop agar fungsi SwitchDesktop berhasil.

Sintaks

BOOL SwitchDesktop(
  [in] HDESK hDesktop
);

Parameter

[in] hDesktop

Handel ke desktop. Handel ini dikembalikan oleh fungsi CreateDesktop dan OpenDesktop .

Desktop ini harus dikaitkan dengan stasiun jendela saat ini untuk proses tersebut.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. Namun, SwitchDesktop hanya menetapkan kesalahan terakhir untuk kasus berikut:

  • Ketika desktop milik stasiun jendela yang tidak terlihat
  • Ketika hDesktop adalah handel yang tidak valid, mengacu pada desktop yang dihancurkan, atau milik sesi yang berbeda dari proses panggilan

Keterangan

Fungsi SwitchDesktop gagal jika desktop milik stasiun jendela yang tidak terlihat. SwitchDesktop juga gagal ketika dipanggil dari proses yang terkait dengan desktop aman seperti desktop WinLogon dan ScreenSaver. Proses yang terkait dengan desktop aman mencakup proses UserInit kustom. Panggilan tersebut biasanya gagal dengan kesalahan "akses ditolak".

Persyaratan

   
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header winuser.h (termasuk Windows.h)
Pustaka User32.lib
DLL User32.dll
Set API ext-ms-win-ntuser-windowstation-l1-1-0 (diperkenalkan di Windows 8)

Lihat juga

CreateDesktop

Desktop

OpenDesktop

Stasiun Jendela dan Fungsi Desktop