ActiveDirectoryMembershipProvider.ChangePassword Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Belirtilen kullanıcının parolasını değiştirir.
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 -> boolPublic Overrides Function ChangePassword (username As String, oldPassword As String, newPassword As String) As BooleanParametreler
- username
- String
Parolasının güncelleştirilecek kullanıcı adı.
- oldPassword
- String
Belirtilen kullanıcının geçerli parolası.
- newPassword
- String
Belirtilen kullanıcının yeni parolası.
Döndürülenler
true parola başarıyla güncelleştirildiyse; aksi takdirde , false.
Özel durumlar
username boş veya kullanıcı adı için uzunluk üst sınırını (genellikle 256 karakter) aşıyor.
-veya-
username virgül içerir.
-veya-
Kullanıcı adı özniteliğine userPrincipalName eşlenir ve username parametresi ters eğik çizgi içerir.
-veya-
oldPassword veya newPassword sıfır uzunluklu bir dizedir.
-veya-
oldPassword veya newPassword en fazla parola uzunluğunu (genellikle 128 karakter) aşıyor.
-veya-
newPassword özelliğinde belirtilen en düşük parola boyutundan MinRequiredPasswordLength küçük
-veya-
newPassword özelliğinde belirtilen alfabetik olmayan karakter sayısından MinRequiredNonAlphanumericCharacters daha azını içerir.
-veya-
newPassword özelliğinde PasswordStrengthRegularExpression tanımlanan normal ifade tarafından doğrulanamadı.
username, null değeridir.
-veya-
oldPassword, null değeridir.
-veya-
newPassword, null değeridir.
newPassword Active Directory sunucusu tarafından tanımlanan karmaşıklık gereksinimlerini karşılamaz.
Active Directory Uygulama Modu sunucusuna güvenli bir bağlantı oluşturulamadı.
ChangePassword(String, String, String) Yöntem, örnek başlatılmadan önce ActiveDirectoryMembershipProvider çağrılır.
İşlenmeyen bir özel durum oluştu.
Açıklamalar
ChangePassword yöntemi, Active Directory veri deposunda kullanıcının parolasını güncelleştirmek için kullanılır. Örneğin kullanmak üzere yapılandırıldığı kimlik bilgileri ActiveDirectoryMembershipProvider ne olursa olsun, sağlayıcı bağlantı kimlik bilgileri olarak ve oldPassword parametrelerini kullanarak username Active Directory sunucusuna bağlanır.
EnablePasswordReset özelliği isetrue, kullanıcı parola sorusunu yanıtlamak için çok fazla deneme yaptığından hesap daha önce kilitlenmişse kullanıcı parolasını değiştiremez. Kullanıcının parolayı değiştirmeden önce özelliğinde PasswordAnswerAttemptLockoutDuration belirtilen dakika sayısını beklemesi gerekir.
Parola değişikliği başarılı olursa ve EnablePasswordReset özelliği ise truekullanıcının hatalı parola yanıt izleme sayaçları sıfırlanır.
Sağlayıcı, bağlantı dizesinde belirtilen arama noktasından başlayarak kullanıcı adı için bir alt ağaç araması gerçekleştirerek güncelleştirilecek kullanıcı örneğini bulur. ActiveDirectoryMembershipProvider Bağlantı dizeleri hakkında daha fazla bilgi için sınıf konusuna bakın.
Bir Active Directory sunucusundaki parolaları değiştirmek için özniteliği olarak connectionProtection ayarlanmalıdır SignAndSeal.
ADAM sunucusu kullanılırken, connectionProtection özniteliği olarak ayarlanabilir None, ancak yalnızca ADAM sunucusunu güvenli olmayan bağlantılar üzerinden parola değişikliğine izin verecek şekilde açıkça yapılandırıyorsanız.
