다음을 통해 공유


PrincipalSearcher.FindOne 메서드

정의

QueryFilter 속성에 지정된 보안 주체와 일치하는 첫 번째 보안 주체 개체를 포함하는 보안 주체 검색 결과를 반환합니다.

public:
 System::DirectoryServices::AccountManagement::Principal ^ FindOne();
public System.DirectoryServices.AccountManagement.Principal FindOne ();
[System.Security.SecurityCritical]
public System.DirectoryServices.AccountManagement.Principal FindOne ();
member this.FindOne : unit -> System.DirectoryServices.AccountManagement.Principal
[<System.Security.SecurityCritical>]
member this.FindOne : unit -> System.DirectoryServices.AccountManagement.Principal
Public Function FindOne () As Principal

반환

Principal 쿼리 필터와 일치하는 주체 개체가 들어 있거나 null 결과가 없는 경우 개체입니다.

특성

예외

QueryFilter에 참조 속성이 포함되는 경우 자세한 내용은 예제에 의한 쿼리 개요 항목을 참조하십시오.

QueryFilter가 유지되는 보안 주체인 경우

쿼리를 수행할 수 있으려면 먼저 보안 주체 검색자에 QueryFilter를 할당해야 하는 경우

설명

에 지정 된 개체의 정확히 하나의 일치 항목 인지를 QueryFilter,이 메서드는 개체를 반환 합니다. 여러 일치 항목이 없으면는 QueryFilter 개체를 일치 하는 보안 주체 중 하나는이 메서드가 임의로 반환 합니다.

합니다 Principal 이 메서드에서 반환 된 개체에 포함 된 개체의 형식과 일치 하는 QueryFilter 속성입니다. 검색에서 지정 된 컨텍스트에서 수행 하는 Context 속성입니다. 자세한 내용은 예제에 의한 쿼리 개요 항목을 참조하십시오.

적용 대상

추가 정보