UserPrincipal.FindByIdentity Metoda

Definicja

Przestrzeń nazw:

System.DirectoryServices.AccountManagement

Zestaw:

System.DirectoryServices.AccountManagement.dll

Pakiet:

System.DirectoryServices.AccountManagement v8.0.0

Zwraca obiekt podmiotu zabezpieczeń użytkownika, który jest zgodny z określoną wartością tożsamości.

Przeciążenia

FindByIdentity(PrincipalContext, IdentityType, String)	Zwraca obiekt podmiotu zabezpieczeń użytkownika, który jest zgodny z określonym typem tożsamości i wartością. Ta wersja FindByIdentity metody określa format wartości tożsamości.
FindByIdentity(PrincipalContext, String)	Zwraca obiekt podmiotu zabezpieczeń użytkownika, który jest zgodny z określoną wartością tożsamości.

FindByIdentity(PrincipalContext, IdentityType, String)

Źródło:

User.cs

Zwraca obiekt podmiotu zabezpieczeń użytkownika, który jest zgodny z określonym typem tożsamości i wartością. Ta wersja FindByIdentity metody określa format wartości tożsamości.

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

Parametry

context

PrincipalContext

Określa PrincipalContext serwer lub domenę, względem których są wykonywane operacje.

identityType

IdentityType

IdentityType Wartość wyliczenia określająca format parametruidentityValue.

identityValue

String

Tożsamość podmiotu zabezpieczeń użytkownika. Ten parametr może mieć dowolny format zawarty w wyliczenie IdentityType .

Zwraca

UserPrincipal

UserPrincipal Obiekt, który jest zgodny z określoną wartością tożsamości i typem lub wartością null, jeśli nie znaleziono dopasowań.

Wyjątki

MultipleMatchesException

Znaleziono wiele obiektów głównych użytkowników pasujących do bieżącego obiektu użytkownika.

InvalidEnumArgumentException

Wartość tożsamości nie jest prawidłową IdentityType wartością wyliczenia.

Przykłady

Poniższy kod łączy się z magazynem komputerów lokalnych. Ponieważ poświadczenia nie są określone w konstruktorze PrincipalContext , używane są poświadczenia użytkownika uruchamiającego bieżący wątek.

Wyszukiwanie jest wykonywane w celu znalezienia użytkownika, który ma nazwę SamAccountName "Guest".

Jeśli użytkownik zostanie znaleziony, zostanie wykonana kontrola w celu ustalenia, czy konto tego użytkownika jest włączone. Jeśli konto nie jest włączone, przykładowy kod go włącza.

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)

Źródło:

User.cs

Zwraca obiekt podmiotu zabezpieczeń użytkownika, który jest zgodny z określoną wartością tożsamości.

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

Parametry

context

PrincipalContext

Określa PrincipalContext serwer lub domenę, względem których są wykonywane operacje.

identityValue

String

Tożsamość podmiotu zabezpieczeń użytkownika. Ten parametr może mieć dowolny format zawarty w wyliczenie IdentityType .

Zwraca

UserPrincipal

UserPrincipal Obiekt, który jest zgodny z określoną wartością tożsamości lub ma wartość null, jeśli nie znaleziono dopasowań.

Wyjątki

MultipleMatchesException

Znaleziono wiele obiektów głównych użytkowników pasujących do bieżącego obiektu użytkownika.