ActiveDirectoryMembershipProvider.UnlockUser(String) 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

清除鎖定，讓成員資格使用者能夠進行驗證。

public:
 override bool UnlockUser(System::String ^ username);

public override bool UnlockUser (string username);

override this.UnlockUser : string -> bool

Public Overrides Function UnlockUser (username As String) As Boolean

要清除鎖定狀態之成員資格使用者的名稱。

Boolean

如果成功解除鎖定成員資格使用者，則為 true，否則為 false。當資料存放區中找不到成員資格使用者時，UnlockUser(String) 方法也會傳回 false。

username 是空的，或超過使用者名稱所允許的最大長度 (通常為 256 個字元)。

-或-

username 包含逗號。

-或-

使用者名稱對應至 userPrincipalName，但 username 參數包含反斜線。

username 為 null。

UnlockUser(String) 方法的呼叫，會在初始化 ActiveDirectoryMembershipProvider 執行個體之前進行。

使用者最常遭到鎖定，而且在MaxInvalidPasswordAttempts屬性中指定的PasswordAttemptWindow時間內超過屬性時，或嘗試使用錯誤的密碼登入時，方法無法驗證ValidateUser。

EnablePasswordReset如果屬性為 true，當使用者解除鎖定時，就會重設錯誤密碼的計數器。

提供者會使用從連接字串中指定的搜尋點開始的子樹搜尋。 ActiveDirectoryMembershipProvider如需連接字串的詳細資訊，請參閱類別主題。

會修剪 username 參數值中的前置空格和後端空格。