ldap_search_init_page 함수(winldap.h)

아티클
08/27/2023

ldap_search_init_page 함수는 간단한 페이징 결과 검색에 대한 검색 블록을 초기화합니다. 이 함수는 LDAP 3에서 지원됩니다.

구문

WINLDAPAPI PLDAPSearch LDAPAPI ldap_search_init_page(
  [in] PLDAP        ExternalHandle,
  [in] const PSTR   DistinguishedName,
  [in] ULONG        ScopeOfSearch,
  [in] const PSTR   SearchFilter,
  [in] PZPSTR       AttributeList,
  [in] ULONG        AttributesOnly,
  [in] PLDAPControl *ServerControls,
  [in] PLDAPControl *ClientControls,
  [in] ULONG        PageTimeLimit,
  [in] ULONG        TotalSizeLimit,
  [in] PLDAPSortKey *SortKeys
);

매개 변수

[in] ExternalHandle

세션 핸들입니다.

[in] DistinguishedName

검색을 시작할 항목의 고유 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] ScopeOfSearch

검색의 scope 나타내기 위해 다음 값 중 하나를 지정하는 데이터 형식입니다.

LDAP_SCOPE_BASE

기본 항목만 검색합니다.

LDAP_SCOPE_ONELEVEL

기본 항목을 제외한 기본 항목 아래의 첫 번째 수준에서 모든 항목을 검색합니다.

LDAP_SCOPE_SUBTREE

기본 항목 및 기본 아래 트리의 모든 항목을 검색합니다.

[in] SearchFilter

검색 필터를 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 자세한 내용은 검색 필터 구문을 참조하세요.

[in] AttributeList

일치하는 각 항목에 대해 반환할 특성을 나타내는 null로 끝나는 null로 끝나는 문자열 배열입니다. NULL을 전달하여 사용 가능한 모든 특성을 검색합니다.

[in] AttributesOnly

특성 형식과 값이 모두 반환될 경우 0이어야 하는 부울 값이며, 형식만 반환될 경우 0이 아닙니다.

[in] ServerControls

LDAP 서버 컨트롤 목록입니다.

[in] ClientControls

클라이언트 컨트롤 목록입니다.

[in] PageTimeLimit

클라이언트가 서버가 페이지를 반환할 때까지 대기하는 시간 값(초)입니다.

[in] TotalSizeLimit

클라이언트가 허용할 최대 항목 수입니다. TotalSizeLimit 값은 페이징된 검색 내의 개별 페이지에만 영향을 줍니다(전체 페이징 검색이 아님). 따라서 TotalSizeLimit 가 페이지 크기보다 크면 TotalSizeLimit 는 효과가 없습니다.

[in] SortKeys

특성 유형, 순서 규칙 및 검색 방향을 지정하는 LDAPSortKey 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 LDAPSearch 구조체에 대한 포인터를 반환합니다.

함수가 실패하면 반환 값은 NULL입니다. LdapGetLastError 또는 GetLastError를 사용하여 오류 코드를 검색합니다.

반환된 구조를 해제하려면 ldap_search_abandon_page 호출합니다.

설명

ldap_search_init_page 함수는 페이징된 검색을 관리하기 위한 LDAPSearch 구조를 만들고 구조체에 대한 핸들을 반환합니다. ldap_get_next_page, ldap_get_next_page_s 및 ldap_get_paged_count 함수에는 이 검색 핸들이 매개 변수로 필요합니다. 페이징된 검색이 완료되면 ldap_search_abandon_page 호출하여 이 구조체와 해당 핸들을 해제합니다.

서버가 페이징 결과 검색을 지원하는지 여부를 확인하려면 OID(개체 식별자)의 루트에서 supportedControl 속성을 1.2.840.113556.1.4.319로 검사.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	winldap.h
라이브러리	Wldap32.lib
DLL	Wldap32.dll