Поделиться через


ActiveDirectoryMembershipProvider.ChangePassword Метод

Определение

Изменяет пароль заданного пользователя.

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

Параметры

username
String

Имя пользователя, для которого нужно изменить пароль.

oldPassword
String

Текущий пароль заданного пользователя.

newPassword
String

Новый пароль заданного пользователя.

Возвращаемое значение

Значение true, если пароль был успешно обновлен; в противном случае — значение false.

Исключения

Параметр username пустой, или превышает максимальную длину имени пользователя (обычно 256 символов).

-или-

username содержит запятые.

-или-

Имя пользователя отображается на атрибут userPrincipalName и параметр username содержит обратные косые черты.

-или-

Параметр oldPassword или параметр newPassword является строкой нулевой длины.

-или-

Параметр oldPassword или newPassword превышает максимальную длину пароля (обычно 128 символов).

-или-

Длина параметра newPassword меньше минимальной длины пароля, указанной в свойстве MinRequiredPasswordLength.

-или-

Параметр newPassword содержит меньше нетекстовых символов, чем определено в свойстве MinRequiredNonAlphanumericCharacters.

-или-

Параметру newPassword не удается пройти проверку регулярным выражением, определенным в свойстве PasswordStrengthRegularExpression.

username имеет значение null.

-или-

oldPassword имеет значение null.

-или-

newPassword имеет значение null.

Параметр newPassword не удовлетворяет требованиям сложности, определенным сервером Active Directory.

Нельзя создать безопасное подключение к серверу Active Directory Application Mode.

Метод ChangePassword(String, String, String) вызывается до инициализации экземпляра ActiveDirectoryMembershipProvider.

Произошло необработанное исключение.

Комментарии

Метод ChangePassword используется для обновления пароля пользователя в хранилище данных Active Directory. Независимо от учетных данных, для ActiveDirectoryMembershipProvider использования которыми настроен экземпляр, поставщик подключается к серверу Active Directory, используя username параметры и в oldPassword качестве учетных данных подключения.

EnablePasswordReset Если свойство имеет значение true, пользователь не может изменить свой пароль, если учетная запись была заблокирована ранее из-за слишком большого количества попыток ответить на вопрос о пароле. Пользователю потребуется подождать количество минут, указанное в свойстве PasswordAnswerAttemptLockoutDuration , перед изменением пароля.

Если изменение пароля выполнено успешно и EnablePasswordReset свойство имеет значение true, счетчики отслеживания неправильных ответов паролей пользователя сбрасываются.

Поставщик находит экземпляр пользователя для обновления, выполняя поиск имени пользователя по поддереву, начиная с точки поиска, указанной в строке подключения. ActiveDirectoryMembershipProvider Дополнительные сведения о строках подключения см. в разделе о классах.

Чтобы изменить пароли на сервере Active Directory, connectionProtection атрибуту необходимо задать значение SignAndSeal.

При использовании сервера ADAM атрибуту можно присвоить значение None, но только в том случае, connectionProtection если вы явно настроили сервер ADAM, чтобы разрешить изменение пароля через незащищенные подключения.

Применяется к

См. также раздел