Principal.FindByIdentity 메서드

정의

네임스페이스:

System.DirectoryServices.AccountManagement

어셈블리:

System.DirectoryServices.AccountManagement.dll

패키지:

System.DirectoryServices.AccountManagement v8.0.0

지정된 ID 값과 일치하는 보안 주체 개체를 반환합니다.

오버로드

FindByIdentity(PrincipalContext, String)	지정된 ID 값과 일치하는 보안 주체 개체를 반환합니다.
FindByIdentity(PrincipalContext, IdentityType, String)	지정된 ID 형식 및 값과 일치하는 보안 주체 개체를 반환합니다. 이 버전의 FindByIdentity(PrincipalContext, IdentityType, String) 메서드는 ID 값의 형식을 결정합니다.

FindByIdentity(PrincipalContext, String)

Source:

Principal.cs

지정된 ID 값과 일치하는 보안 주체 개체를 반환합니다.

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

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

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

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

매개 변수

context

PrincipalContext

작업이 수행되는 서버 또는 도메인을 지정하는 PrincipalContext입니다.

identityValue

String

보안 주체의 ID입니다. 이 매개 변수는 IdentityType 열거형에 포함된 임의 형식일 수 있습니다.

반환

Principal

지정된 ID 값 및 형식과 일치하는 Principal 개체이거나, 일치하는 항목이 없으면 null입니다.

예외

MultipleMatchesException

현재 개체와 일치하는 여러 보안 주체 개체를 찾은 경우

FindByIdentity(PrincipalContext, IdentityType, String)

Source:

Principal.cs

지정된 ID 형식 및 값과 일치하는 보안 주체 개체를 반환합니다. 이 버전의 FindByIdentity(PrincipalContext, IdentityType, String) 메서드는 ID 값의 형식을 결정합니다.

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

public static System.DirectoryServices.AccountManagement.Principal 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.Principal

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

매개 변수

context

PrincipalContext

작업이 수행되는 서버 또는 도메인을 지정하는 PrincipalContext입니다.

identityType

IdentityType

identityValue 매개 변수의 형식을 지정하는 IdentityType 열거형 값입니다.

identityValue

String

보안 주체의 ID입니다. 이 매개 변수는 IdentityType 열거형에 포함된 임의 형식일 수 있습니다.

반환

Principal

지정된 ID 값 및 형식과 일치하는 Principal 개체이거나, 일치하는 항목이 없으면 null입니다.

예외

MultipleMatchesException

현재 개체와 일치하는 여러 보안 주체 개체를 찾은 경우

InvalidEnumArgumentException

ID 형식이 유효한 IdentityType 열거형 값이 아닌 경우