UserPrincipal.FindByIdentity Methode

Definition

Namespace:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Gibt ein Benutzerprinzipalobjekt zurück, das dem angegebenen Identitätswert entspricht.

Überlädt

FindByIdentity(PrincipalContext, IdentityType, String)	Gibt ein Benutzerprinzipalobjekt zurück, das dem angegebenen Identitätstyp und -wert entspricht. Diese Version der FindByIdentity-Methode bestimmt das Format des Identitätswerts.
FindByIdentity(PrincipalContext, String)	Gibt ein Benutzerprinzipalobjekt zurück, das dem angegebenen Identitätswert entspricht.

FindByIdentity(PrincipalContext, IdentityType, String)

Gibt ein Benutzerprinzipalobjekt zurück, das dem angegebenen Identitätstyp und -wert entspricht. Diese Version der FindByIdentity-Methode bestimmt das Format des Identitätswerts.

public:
 static System::DirectoryServices::AccountManagement::UserPrincipal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);

public static System.DirectoryServices.AccountManagement.UserPrincipal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);

static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> System.DirectoryServices.AccountManagement.UserPrincipal

Public Shared Function FindByIdentity (context As PrincipalContext, identityType As IdentityType, identityValue As String) As UserPrincipal

Parameter

context

PrincipalContext

Der PrincipalContext, der den Server oder die Domäne angibt, für den bzw. die Vorgänge ausgeführt werden.

identityType

IdentityType

Ein IdentityType-Enumerationswert, der das Format des identityValue-Parameters angibt.

identityValue

String

Die Identität des Benutzerprinzipals. Dieser Parameter kann ein beliebiges Format aufweisen, das in der IdentityType-Enumeration enthalten ist.

Gibt zurück

UserPrincipal

Ein UserPrincipal-Objekt, das dem angegebenen Identitätswert und -typ entspricht, oder NULL, wenn keine Übereinstimmungen gefunden werden.

Ausnahmen

MultipleMatchesException

Es wurden mehrere Benutzerprinzipalobjekte gefunden, die dem aktuellen Benutzerobjekt entsprechen.

InvalidEnumArgumentException

Der Identitätswert ist kein gültiger IdentityType-Enumerationswert.

Beispiele

Mit dem folgenden Code wird eine Verbindung mit dem lokalen Computerspeicher herstellt. Da die Anmeldeinformationen nicht im Konstruktor angegeben sind, werden die Anmeldeinformationen des Benutzers verwendet, PrincipalContext der den aktuellen Thread ausgeführt.

Es wird eine Suche durchgeführt, um den Benutzer zu finden, der über SamAccountName "Guest" verfügt.

Wenn der Benutzer gefunden wird, wird überprüft, ob das Konto dieses Benutzers aktiviert ist. Wenn das Konto nicht aktiviert ist, wird es im Beispielcode aktiviert.

PrincipalContext ctx = new PrincipalContext(ContextType.Machine);  

UserPrincipal usr = UserPrincipal.FindByIdentity(ctx,   
                                           IdentityType.SamAccountName,   
                                           "Guest");  

if(usr != null)  
{  
    if (usr.Enabled == false)  
        usr.Enabled = true;  

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

FindByIdentity(PrincipalContext, String)

Gibt ein Benutzerprinzipalobjekt zurück, das dem angegebenen Identitätswert entspricht.

public:
 static System::DirectoryServices::AccountManagement::UserPrincipal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::String ^ identityValue);

public static System.DirectoryServices.AccountManagement.UserPrincipal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, string identityValue);

static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * string -> System.DirectoryServices.AccountManagement.UserPrincipal

Public Shared Function FindByIdentity (context As PrincipalContext, identityValue As String) As UserPrincipal

Parameter

context

PrincipalContext

Der PrincipalContext, der den Server oder die Domäne angibt, für den bzw. die Vorgänge ausgeführt werden.

identityValue

String

Die Identität des Benutzerprinzipals. Dieser Parameter kann ein beliebiges Format aufweisen, das in der IdentityType-Enumeration enthalten ist.

Gibt zurück

UserPrincipal

Ein UserPrincipal-Objekt, das dem angegebenen Identitätswert entspricht, oder NULL, wenn keine Übereinstimmungen gefunden werden.

Ausnahmen

MultipleMatchesException

Es wurden mehrere Benutzerprinzipalobjekte gefunden, die dem aktuellen Benutzerobjekt entsprechen.