Fungsi NPPasswordChangeNotify (npapi.h)

  • Artikel

Catatan

API ini tidak digunakan lagi dan akan dihapus dalam rilis mendatang.

MPR memanggil fungsi ini untuk memberi tahu manajer kredensial tentang peristiwa perubahan kata sandi. Fungsi NPPasswordChangeNotify diimplementasikan oleh DLL manajer kredensial.

Sintaks

DWORD NPPasswordChangeNotify(
  [in] LPCWSTR lpAuthentInfoType,
  [in] LPVOID  lpAuthentInfo,
  [in] LPCWSTR lpPreviousAuthentInfoType,
  [in] LPVOID  lpPreviousAuthentInfo,
  [in] LPWSTR  lpStationName,
  [in] LPVOID  StationHandle,
  [in] DWORD   dwChangeInfo
);

Parameter

[in] lpAuthentInfoType

Penunjuk ke string yang mengidentifikasi jenis struktur yang ditujukkan oleh lpAuthentInfo.

Ketika Microsoft adalah pengautentikasi utama, string berikut ditentukan untuk masuk pengontrol interaktif dan layanan.

MSV1_0:Interactive 
Kerberos:Interactive

[in] lpAuthentInfo

Penunjuk ke struktur yang berisi kredensial baru.

Ketika Microsoft adalah pengautentikasi utama (yaitu, ketika lpAuthentifoType adalah "MSV1_0:Interactive" atau "Kerberos:Interactive"), struktur yang digunakan MSV1_0_INTERACTIVE_LOGON atau KERB_INTERACTIVE_LOGON.

[in] lpPreviousAuthentInfoType

Penunjuk ke string yang mengidentifikasi jenis struktur yang diacu oleh lpPreviousAuthentInfo. Jika penunjuk ADALAH NULL, tidak ada informasi sebelumnya. Nilai yang diharapkan di sini sama dengan yang ada di lpAuthentInfoType.

Ketika Microsoft adalah pengautentikasi utama, string berikut ditentukan untuk masuk pengontrol interaktif dan layanan.

MSV1_0:Interactive

[in] lpPreviousAuthentInfo

Penunjuk ke struktur yang berisi kredensial yang digunakan sebelum informasi autentikasi berubah. Informasi sebelumnya diberikan jika pengguna dipaksa untuk mengubah kata sandi (atau informasi autentikasi lainnya) sebelum masuk. Jika pengguna tidak dipaksa untuk mengubah informasi autentikasi, penunjuk ini adalah NULL. Nilai yang diharapkan di sini sama dengan yang ada di lpAuthentInfo.

Saat Microsoft adalah pengautentikasi utama, struktur yang digunakan MSV1_0_INTERACTIVE_LOGON atau KERB_INTERACTIVE_LOGON.

[in] lpStationName

Penunjuk ke string yang menentukan nama stasiun tempat pengguna masuk. Nama stasiun dapat digunakan untuk menentukan apakah informasi khusus penyedia tambahan dapat diperoleh.

Ketika Microsoft adalah pengautentikasi utama, salah satu string berikut akan ditentukan.

Nilai Makna
WinSta_0
 Menunjukkan bahwa ini adalah log masuk interaktif melalui stasiun jendela. Dalam hal ini, StationHandle adalah HWND ke kotak dialog induk.
SvcCtl
 Menunjukkan bahwa ini adalah log masuk yang dimulai oleh pengontrol layanan. StationHandle tidak digunakan dalam kasus ini.

[in] StationHandle

Nilai 32-bit yang maknanya tergantung pada nama (dan akibatnya, jenis) stasiun yang ditentukan dalam lpStationName.

Nilai Makna
WinSta_0
 Handel ke kotak dialog pemilik (hwndOwner) yang saat ini ditampilkan di layar.
SvcCtl
 Data acak. Jangan gunakan.

[in] dwChangeInfo

Jika diatur, menentukan bendera yang menyediakan informasi perubahan. Parameter ini bisa menjadi salah satu bendera.

Nilai Makna
WN_VALID_LOGON_ACCOUNT
 Bendera ini menunjukkan bahwa informasi autentikasi yang diubah akan memengaruhi semua logon di masa mendatang. Pengguna milik domain tepercaya.
WN_NT_PASSWORD_CHANGED
 Bendera ini menunjukkan bahwa kata sandi telah diubah.

Beberapa perubahan informasi autentikasi hanya akan memengaruhi koneksi yang dibuat di domain yang tidak tepercaya. Ini adalah akun yang tetap tidak dapat digunakan pengguna untuk masuk ke komputer ini. Dalam kasus ini, dwChangeInfo tidak diatur.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan WN_SUCCESS.

Jika fungsi gagal, fungsi mengembalikan kode kesalahan, yang bisa menjadi salah satu nilai berikut.

Menampilkan kode Deskripsi
WN_NOT_SUPPORTED

NPPasswordChangeNotify tidak didukung.
WN_NO_NETWORK
 Jaringan tidak ada.
WN_FUNCTION_BUSY
 Manajer kredensial masih menginisialisasi dan belum siap untuk dipanggil.

Keterangan

Fungsi NPPasswordChangeNotify diimplementasikan oleh manajer kredensial untuk menerima pemberitahuan saat informasi autentikasi berubah.

Windows Server 2003 dan Windows XP: NPPasswordChangeNotify dipanggil di komputer tempat pengguna masuk jika kata sandi telah diubah di tempat lain. Perhatikan bahwa perilaku ini tidak didukung dimulai dengan Windows Vista dan Windows Server 2008.

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

Lihat juga

MSV1_0_INTERACTIVE_LOGON

NPGetCaps

NPLogonNotify