Aracılığıyla paylaş


ActiveDirectoryMembershipProvider.ChangePassword Yöntem

Tanım

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 -> bool
Public Overrides Function ChangePassword (username As String, oldPassword As String, newPassword As String) As Boolean

Parametreler

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ı.

İş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.

Şunlara uygulanır

Ayrıca bkz.