AuthenticablePrincipal.UnlockAccount 方法

定義

命名空間:

System.DirectoryServices.AccountManagement

組件:

System.DirectoryServices.AccountManagement.dll

套件:

System.DirectoryServices.AccountManagement v8.0.0

來源:

AuthenticablePrincipal.cs

如果帳戶目前遭鎖定，則解除鎖定。

public:
 void UnlockAccount();

public void UnlockAccount ();

member this.UnlockAccount : unit -> unit

Public Sub UnlockAccount ()

例外狀況

PrincipalOperationException

呼叫者沒有適當的權限。

-或-

將變更儲存至存放區時，就會發生例外狀況。

範例

下列範例程式代碼會使用在建構函式中 PrincipalContext 初始化的用戶名稱 (系統管理員) 和密碼 (SecretPwd123) ，連接到 LDAP 網域 “fabrikam.com”。

系統會執行搜尋，以在建構函式中指定的 PrincipalContext 容器下尋找名稱為 “John Smith” 的使用者：“CN=Users，DC=fabrikam，DC=com”。如果找到使用者，則會執行檢查，以判斷此用戶的帳戶是否已遭到鎖定。如果帳戶已鎖定，程式代碼範例會解除鎖定帳戶。

PrincipalContext ctx = new PrincipalContext(ContextType.Domain,   
                                         "fabrikam.com",   
                                         "CN=Users,DC=fabrikam,DC=com",   
                                         "administrator",   
                                         "SecretPwd123");  

UserPrincipal usr = UserPrincipal.FindByIdentity(ctx, "John Smith");  
if (usr != null)  
{  
    if (usr.IsAccountLockedOut())  
        usr.UnlockAccount();  

    usr.Dispose();  
}  
ctx.Dispose();