Fungsi WlxLoggedOnSAS (winwlx.h)

  • Artikel

[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