Fungsi WlxLoggedOnSAS (winwlx.h)

Artikel
03/08/2023

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

Fungsi WlxLoggedOnSAS harus diimplementasikan oleh DLL GINA pengganti. Winlogon memanggil fungsi ini ketika menerima peristiwa urutan perhatian aman (SAS) saat pengguna masuk dan stasiun kerja tidak dikunci.

Catatan DLL GINA diabaikan di Windows Vista.

Sintaks

int WlxLoggedOnSAS(
  [in] PVOID pWlxContext,
  [in] DWORD dwSasType,
  [in] PVOID pReserved
);

Parameter

[in] pWlxContext

Penunjuk ke konteks GINA yang terkait dengan stasiun jendela ini. GINA mengembalikan nilai konteks ini ketika Winlogon memanggil WlxInitialize untuk stasiun ini.

[in] dwSasType

Menentukan jenis SAS yang terjadi. Nilai dari nol hingga WLX_SAS_TYPE_MAX_MSFT_VALUE dicadangkan untuk menentukan jenis Microsoft SAS standar. Pengembang GINA dapat menentukan jenis SAS tambahan dengan menggunakan nilai yang lebih besar dari WLX_SAS_TYPE_MAX_MSFT_VALUE.

Jenis SAS berikut telah ditentukan sebelumnya.

Nilai	Makna
WLX_SAS_TYPE_TIMEOUT 0 (0x0)	Menunjukkan bahwa tidak ada input pengguna yang diterima dalam periode waktu habis yang ditentukan.
WLX_SAS_TYPE_CTRL_ALT_DEL 1 (0x1)	Menunjukkan bahwa pengguna telah mengetik urutan perhatian aman (SAS) CTRL+ALT+DEL standar.
WLX_SAS_TYPE_SC_INSERT 5 (0x5)	Menunjukkan bahwa kartu pintar telah dimasukkan ke dalam perangkat yang kompatibel.
WLX_SAS_TYPE_SC_REMOVE 6 (0x6)	Menunjukkan bahwa kartu pintar telah dihapus dari perangkat yang kompatibel.

[in] pReserved

Parameter ini dicadangkan dan harus diatur ke NULL.

Mengembalikan nilai

Fungsi WlxLoggedOnSAS harus mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
WLX_SAS_ACTION_NONE	Kembali ke desktop default.
WLX_SAS_ACTION_LOCK_WKSTA	Mengunci stasiun kerja dan menunggu SAS berikutnya.
WLX_SAS_ACTION_LOGOFF	Mencatat pengguna dari stasiun kerja.
WLX_SAS_ACTION_SHUTDOWN	Mencatat pengguna dan mematikan komputer.
WLX_SAS_ACTION_SHUTDOWN_REBOOT	Mencatat pengguna mati, mematikan komputer, lalu memulai ulang komputer.
WLX_SAS_ACTION_SHUTDOWN_POWER_OFF	Jika perangkat keras memperbolehkan, mencatat pengguna mati, mematikan komputer, lalu mematikan komputer.
WLX_SAS_ACTION_PWD_CHANGED	Memberi tahu penyedia jaringan bahwa pengguna mengubah kata sandi mereka. DLL GINA usang harus memanggil WlxChangePasswordNotify setiap kali kata sandi diubah.
WLX_SAS_ACTION_TASKLIST	Memanggil daftar tugas.
WLX_SAS_ACTION_FORCE_LOGOFF	Log paksa pengguna.
WLX_SAS_ACTION_SHUTDOWN_SLEEP	Menempatkan komputer dalam mode tangguhan.
WLX_SAS_ACTION_SHUTDOWN_SLEEP2	Mematikan sistem ke dalam status matikan ACPI. Jika komputer bukan komputer ACPI, opsi ini tidak akan berpengaruh.
WLX_SAS_ACTION_SHUTDOWN_HIBERNATE	Mematikan sistem ke mode hibernasi. Jika sistem tidak dikonfigurasi untuk hibernasi, opsi ini tidak akan berpengaruh.

Keterangan

Winlogon memanggil WlxLoggedOnSAS ketika pengguna yang masuk ingin mematikan, keluar, atau mengunci stasiun kerja. DLL GINA dapat mengunci stasiun kerja dengan mengembalikan WLX_SAS_ACTION_LOCK_WKSTA. Ketika nilai ini dikembalikan, Winlogon mengunci stasiun kerja dan memanggil WlxWkstaLockedSAS saat berikutnya menerima SAS.

Sebelum memanggil WlxLoggedOnSAS, Winlogon mengatur status desktop sehingga desktop saat ini adalah desktop Winlogon dan mengatur status stasiun kerja sehingga desktop terkunci.

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

WlxInitialize

WlxWkstaLockedSAS

Bagikan melalui