ActiveDirectoryMembershipProvider.ChangePassword Metode

Definisi

Ruang nama:

System.Web.Security

Rakitan:

System.Web.dll

Mengubah kata sandi untuk pengguna yang ditentukan.

public:
 override bool ChangePassword(System::String ^ username, System::String ^ oldPassword, System::String ^ newPassword);

public override bool ChangePassword (string username, string oldPassword, string newPassword);

override this.ChangePassword : string * string * string -> bool

Public Overrides Function ChangePassword (username As String, oldPassword As String, newPassword As String) As Boolean

Parameter

username

String

Nama pengguna untuk memperbarui kata sandi.

oldPassword

String

Kata sandi saat ini untuk pengguna yang ditentukan.

newPassword

String

Kata sandi baru untuk pengguna yang ditentukan.

Mengembalikan

Boolean

true jika kata sandi berhasil diperbarui; jika tidak, false.

Pengecualian

ArgumentException

username kosong, atau melebihi panjang maksimum untuk nama pengguna (biasanya 256 karakter).

-atau-

username berisi koma.

-atau-

Nama pengguna dipetakan ke userPrincipalName atribut dan username parameter berisi garis miring terbalik.

-atau-

oldPassword atau newPassword adalah string panjang nol.

-atau-

oldPassword atau newPassword melebihi panjang kata sandi maksimum (biasanya 128 karakter).

-atau-

newPassword kurang dari ukuran kata sandi minimum yang ditentukan dalam MinRequiredPasswordLength properti

-atau-

newPassword berisi kurang dari jumlah karakter non-alfabet yang ditentukan dalam MinRequiredNonAlphanumericCharacters properti .

-atau-

newPassword gagal validasi oleh ekspresi reguler yang ditentukan dalam PasswordStrengthRegularExpression properti .

ArgumentNullException

usernameadalah null.

-atau-

oldPasswordadalah null.

-atau-

newPasswordadalah null.

MembershipPasswordException

newPassword tidak memenuhi persyaratan kompleksitas yang ditentukan oleh server Direktori Aktif.

ProviderException

Koneksi aman tidak dapat dilakukan ke server Mode Aplikasi Direktori Aktif.

InvalidOperationException

Metode ChangePassword(String, String, String) ini dipanggil sebelum instans diinisialisasi ActiveDirectoryMembershipProvider .

Exception

Terjadi pengecualian yang tidak tertangani.

Keterangan

Metode ChangePassword ini digunakan untuk memperbarui kata sandi pengguna di penyimpanan data Direktori Aktif. Terlepas dari kredensial yang dikonfigurasi ActiveDirectoryMembershipProvider instans untuk digunakan, penyedia terhubung ke server Direktori Aktif menggunakan username parameter dan oldPassword sebagai kredensial koneksi.

EnablePasswordReset Jika properti adalah true, pengguna tidak dapat mengubah kata sandi mereka jika akun sebelumnya dikunci karena pengguna melakukan terlalu banyak upaya untuk menjawab pertanyaan kata sandi. Pengguna harus menunggu jumlah menit yang ditentukan dalam PasswordAnswerAttemptLockoutDuration properti sebelum mengubah kata sandi.

Jika perubahan kata sandi berhasil dan EnablePasswordReset properti adalah true, maka penghitung pelacakan jawaban kata sandi pengguna yang buruk diatur ulang.

Penyedia menemukan instans pengguna untuk diperbarui dengan melakukan pencarian subtree untuk nama pengguna yang dimulai dari titik pencarian yang ditentukan dalam string koneksi. ActiveDirectoryMembershipProvider Lihat topik kelas untuk informasi selengkapnya tentang string koneksi.

Untuk mengubah kata sandi di server connectionProtection Direktori Aktif, atribut harus diatur ke SignAndSeal.

Saat menggunakan server ADAM, connectionProtection atribut dapat diatur ke None, tetapi hanya jika Anda secara eksplisit mengonfigurasi server ADAM untuk memungkinkan perubahan kata sandi melalui koneksi yang tidak aman.

Lihat juga

• Pengantar Keanggotaan ASP.NET