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 -> boolPublic 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, чтобы разрешить изменение пароля через незащищенные подключения.
