Fungsi WlxScreenSaverNotify (winwlx.h)

Artikel
03/04/2024

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

Fungsi WlxScreenSaverNotify dapat diimplementasikan oleh DLL GINA pengganti. Winlogon memanggil fungsi ini segera sebelum pengaman layar diaktifkan, memungkinkan GINA berinteraksi dengan program pengaman layar.

Catatan DLL GINA diabaikan di Windows Vista.

Sintaks

BOOL WlxScreenSaverNotify(
  [in]      PVOID pWlxContext,
  [in, out] BOOL  *pSecure
);

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, out] pSecure

Penunjuk ke nilai Boolean yang, pada input, menentukan apakah pengaman layar saat ini aman dan,

pada output, menunjukkan apakah stasiun kerja harus dikunci.

Nilai kembali

Jika pengaman layar harus diaktifkan, fungsi mengembalikan TRUE.

Jika pengaman layar tidak boleh diaktifkan, fungsi mengembalikan FALSE.

Keterangan

Jika DLL GINA Anda tidak mengekspor fungsi ini, Winlogon menggunakan perilaku default berikut.

#include <windows.h>
#include <Winwlx.h>

BOOL DefaultScreenSaverNotify(
   PVOID   pWlxContext,
   BOOL    *pSecure)
{
  if (*pSecure)
  {
    *pSecure = WlxIsLockOk(pWlxContext);
  }
  return(TRUE);
}

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

Persyaratan

Persyaratan	Nilai
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