PWLX_SET_RETURN_DESKTOP fungsi panggilan balik (winwlx.h)

Artikel
08/28/2023

[Fungsi WlxSetReturnDesktop tidak lagi tersedia untuk digunakan pada Windows Server 2008 dan Windows Vista.]

Dipanggil oleh GINA untuk menentukan desktop aplikasi alternatif yang akan dialihkan Winlogon ketika fungsi pemrosesan peristiwa urutan perhatian aman (SAS) saat ini selesai.

Catatan DLL GINA diabaikan di Windows Vista.

Sintaks

PWLX_SET_RETURN_DESKTOP PwlxSetReturnDesktop;

BOOL PwlxSetReturnDesktop(
  [in] HANDLE hWlx,
  [in] PWLX_DESKTOP pDesktop
)
{...}

Parameter

[in] hWlx

Menentukan handel Winlogon yang diteruskan ke GINA dalam panggilan WlxInitialize .

[in] pDesktop

Arahkan ke informasi desktop tentang desktop alternatif. Desktop ini dibuat dengan memanggil fungsi WlxCreateUserDesktop .

Menampilkan nilai

Fungsi WlxSetReturnDesktop mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
TRUE	Panggilan fungsi berhasil.
FALSE	Panggilan fungsi gagal mengatur desktop pengembalian.

Keterangan

WlxSetReturnDesktop hanya dapat dipanggil dalam rutinitas WlxLoggedOnSAS atau WlxWkstaLockedSAS . Upaya untuk memanggil fungsi ini di lain waktu akan gagal.

Jika handel ke desktop disediakan, Winlogon akan menduplikasi handel. Jika tidak ada handel yang disediakan, Winlogon akan mencoba membuka desktop bernama dalam parameter pDesktop . Jika desktop yang disediakan tidak valid atau merupakan desktop Winlogon atau pengaman layar, panggilan akan gagal.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winwlx.h

Lihat juga