Udostępnij za pośrednictwem


UserPrincipal.FindByIdentity Metoda

Definicja

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
Źródło:
User.cs
Ź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 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

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

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();   

Dotyczy

FindByIdentity(PrincipalContext, String)

Źródło:
User.cs
Źródło:
User.cs
Ź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 Obiekt, który jest zgodny z określoną wartością tożsamości lub ma wartość null, jeśli nie znaleziono dopasowań.

Wyjątki

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

Dotyczy