ldap_search 함수(winldap.h)
ldap_search 함수는 LDAP 디렉터리를 검색하고 일치하는 각 항목에 대해 요청된 특성 집합을 반환합니다.
구문
WINLDAPAPI ULONG LDAPAPI ldap_search(
[in] LDAP *ld,
[in] PSTR base,
[in] ULONG scope,
[in] PSTR filter,
[in] PZPSTR attrs,
[in] ULONG attrsonly
);
매개 변수
[in] ld
세션 핸들입니다.
[in] base
검색을 시작할 항목의 고유 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.
[in] scope
검색 scope 나타내기 위해 다음 값 중 하나를 지정하는 데이터 형식입니다.
LDAP_SCOPE_BASE
기본 항목만 검색합니다.
LDAP_SCOPE_ONELEVEL
기본 항목을 제외한 기본 항목 아래의 첫 번째 수준에서 모든 항목을 검색합니다.
LDAP_SCOPE_SUBTREE
기본 항목 및 기본 아래 트리의 모든 항목을 검색합니다.
[in] filter
검색 필터를 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 자세한 내용은 검색 필터 구문을 참조하세요.
[in] attrs
일치하는 각 항목에 대해 반환할 특성을 나타내는 null로 종료된 문자열의 null로 끝나는 배열입니다. NULL을 전달하여 사용 가능한 특성을 검색합니다.
[in] attrsonly
특성 형식과 값이 모두 반환될 경우 0이어야 하는 부울 값이며, 형식만 필요한 경우 0이 아닙니다.
반환 값
함수가 성공하면 검색 작업의 메시지 ID를 반환합니다.
함수가 실패하면 –1을 반환하고 LDAP 데이터 구조에서 세션 오류 매개 변수를 설정합니다.
설명
ldap_search 함수는 비동기 검색 작업을 시작합니다.
ld 세션 핸들과 함께 ldap_set_option 함수를 사용하여 검색 수행 방법을 결정하는 LDAP_OPT_SIZELIMIT, LDAP_OPT_TIMELIMIT 및 LDAP_OPT_DEREF 옵션을 설정합니다. 자세한 내용은 세션 옵션을 참조하세요.
비동기 함수인 ldap_search 작업에 대한 메시지 ID를 반환합니다. 메시지 ID를 사용하여 ldap_result 호출하여 작업 결과를 가져옵니다. 비동기 검색 작업을 완료하기 전에 취소하려면 ldap_abandon 호출합니다.
함수가 결과를 직접 반환하도록 하려면 동기 루틴 ldap_search_s 사용합니다. ldap_search_ext 또는 ldap_search_ext_s 사용하여 LDAP 3 서버 및 클라이언트 컨트롤에 대한 지원을 구현합니다.
다중 스레딩: 함수 호출이 -1 오류 코드를 반환할 때 LdapGetLastError 를 사용하여 실제 세션 오류 코드를 검색하는 경우 ldap_search 호출은 스레드로부터 안전합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | winldap.h |
| 라이브러리 | Wldap32.lib |
| DLL | Wldap32.dll |