PSAM_PASSWORD_NOTIFICATION_ROUTINE fungsi panggilan balik (ntsecapi.h)

Fungsi PasswordChangeNotify diimplementasikan oleh DLL filter kata sandi . Ini memberi tahu DLL bahwa kata sandi telah diubah.

Sintaks

PSAM_PASSWORD_NOTIFICATION_ROUTINE PsamPasswordNotificationRoutine;

NTSTATUS PsamPasswordNotificationRoutine(
  [in] PUNICODE_STRING UserName,
  [in] ULONG RelativeId,
  [in] PUNICODE_STRING NewPassword
)
{...}

Parameter

[in] UserName

Nama akun pengguna yang kata sandinya berubah.

Jika nilai parameter ini dan parameter NewPasswordadalah NULL, fungsi ini harus mengembalikan STATUS_SUCCESS.

[in] RelativeId

Pengidentifikasi relatif (RID) pengguna yang ditentukan dalam UserName.

[in] NewPassword

Kata sandi teks biasa baru untuk pengguna yang ditentukan dalam UserName. Setelah Anda selesai menggunakan kata sandi, hapus informasi dengan memanggil fungsi SecureZeroMemory . Untuk informasi selengkapnya tentang melindungi kata sandi, lihat Menangani Kata Sandi.

Jika nilai parameter ini dan parameter UserNameadalah NULL, fungsi ini harus mengembalikan STATUS_SUCCESS.

Nilai kembali

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Menunjukkan kata sandi pengguna diubah, atau bahwa nilai parameter UserName dan NewPassword adalah NULL.

Keterangan

Fungsi PasswordChangeNotify dipanggil setelah fungsi PasswordFilter berhasil dipanggil dan kata sandi baru telah disimpan.

Fungsi ini harus menggunakan konvensi panggilan __stdcall dan harus diekspor oleh DLL.

Ketika rutinitas PasswordChangeNotify berjalan, pemrosesan diblokir sampai rutinitas selesai. Jika sesuai, pindahkan pemrosesan panjang apa pun ke utas terpisah sebelum kembali dari rutinitas ini.

Fungsi ini dipanggil hanya untuk filter kata sandi yang diinstal dan terdaftar pada sistem.

Setiap pengecualian proses yang tidak ditangani dalam fungsi ini dapat menyebabkan kegagalan terkait keamanan di seluruh sistem. Penanganan pengecualian terstruktur harus digunakan jika sesuai.

Untuk informasi tentang	Lihat
Masalah pemrograman saat menerapkan DLL filter kata sandi	Pertimbangan Pemrograman Filter Kata Sandi
Cara menginstal dan mendaftarkan DLL filter kata sandi Anda sendiri	Menginstal dan Mendaftarkan DLL Filter Kata Sandi
DLL filter kata sandi yang disediakan oleh Microsoft	Penegakan dan Passfilt.dllKata Sandi yang Kuat

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

Lihat juga

InitializeChangeNotify

PasswordFilter