LSA_REGISTER_NOTIFICATION fungsi panggilan balik (ntsecpkg.h)

Artikel
02/29/2024

Menyediakan mekanisme di mana paket keamanan diberi tahu. Pemberitahuan dapat terjadi pada interval tetap, ketika objek peristiwa diberi sinyal, atau selama peristiwa sistem tertentu.

Sintaks

LSA_REGISTER_NOTIFICATION LsaRegisterNotification;

HANDLE LsaRegisterNotification(
  [in] SEC_THREAD_START StartFunction,
  [in] PVOID Parameter,
  [in] ULONG NotificationType,
  [in] ULONG NotificationClass,
  [in] ULONG NotificationFlags,
  [in] ULONG IntervalMinutes,
  [in] HANDLE WaitEvent
)
{...}

Parameter

[in] StartFunction

Fungsi yang dipanggil untuk menerima pemberitahuan.

[in] Parameter

Argumen fungsi yang ditentukan dalam parameter StartFunction .

[in] NotificationType

Menentukan jenis pemberitahuan. Tabel berikut mendaftar nilai-nilai yang valid.

Nilai	Makna
NOTIFIER_TYPE_INTERVAL	Beri tahu pada interval tetap. Gunakan parameter IntervalMinutes untuk menunjukkan panjang interval.
NOTIFIER_TYPE_HANDLE_WAIT	Beri tahu saat handel peristiwa yang ditentukan oleh parameter WaitEvent diberi sinyal.
NOTIFIER_TYPE_STATE_CHANGE	Beri tahu ketika ada perubahan pada domain mesin atau jenis penginstalan.
NOTIFIER_TYPE_NOTIFY_EVENT	Beri tahu saat peristiwa keamanan berlangsung. Gunakan parameter NotificationClass untuk menentukan peristiwa yang menarik.
NOTIFIER_TYPE_IMMEDIATE	Segera beri tahu. Nilai ini menyiratkan NOTIFIER_FLAG_ONE_SHOT.

[in] NotificationClass

Menentukan kelas peristiwa yang menghasilkan pemberitahuan. Tentukan nol kecuali parameter NotificationType diatur ke NOTIFIER_TYPE_NOTIFY_EVENT.

Nilai	Makna
NOTIFY_CLASS_PACKAGE_CHANGE	Paket dimuat, atau paket baru dipilih sebagai paket pilihan. Untuk informasi selengkapnya, lihat Keterangan.
NOTIFY_CLASS_ROLE_CHANGE	Dicadangkan untuk penggunaan internal.
NOTIFY_CLASS_DOMAIN_CHANGE	Dicadangkan untuk penggunaan internal.

[in] NotificationFlags

Menentukan bendera yang mengontrol perilaku pemberitahuan.

Nilai	Makna
NOTIFIER_FLAG_NEW_THREAD	Tunggu pemberitahuan menggunakan utas baru.
NOTIFIER_FLAG_ONE_SHOT	Beri tahu hanya sekali.
NOTIFIER_FLAG_SECONDS	Parameter IntervalMinutes menentukan detik.

[in] IntervalMinutes

Menentukan penundaan waktu antara pemberitahuan.

[in] WaitEvent

Opsional. Menangani ke objek peristiwa. Ketika objek diberi sinyal, pemberitahuan terjadi. Nilai ini digunakan bersama dengan nilai NotificationType NOTIFIER_TYPE_HANDLE_WAIT.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke pemberitahuan.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Keterangan

Jika Anda menentukan nilai NOTIFY_CLASS_PACKAGE_CHANGE untuk parameter NotificationClass , nilai berikut mewakili perubahan yang valid.

Nilai	Deskripsi
SECPKG_PACKAGE_CHANGE_LOAD	Paket dimuat.
SECPKG_PACKAGE_CHANGE_UNLOAD	Paket dibongkar.
SECPKG_PACKAGE_CHANGE_SELECT	Paket baru menjadi paket keamanan pilihan.

Penunjuk ke fungsi RegisterNotification tersedia dalam struktur LSA_SECPKG_FUNCTION_TABLE yang diterima oleh fungsi SpInitialize .

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	ntsecpkg.h

Lihat juga

LSA_SECPKG_FUNCTION_TABLE

SpInitialize