ldap_create_sort_controlW 함수(winldap.h)
ldap_create_sort_control 함수는 정렬 키 목록의 형식을 검색 컨트롤로 지정하는 데 사용됩니다. 컨트롤에 대한 지원은 LDAP 3에서 유효하지만 정렬 컨트롤이 지원되는지 여부는 특정 서버에 종속됩니다.
통사론
WINLDAPAPI ULONG LDAPAPI ldap_create_sort_controlW(
[in] PLDAP ExternalHandle,
[in] PLDAPSortKeyW *SortKeys,
[in] UCHAR IsCritical,
[out] PLDAPControlW *Control
);
매개 변수
[in] ExternalHandle
세션 핸들입니다.
[in] SortKeys
LDAPSortKey 구조체의 배열에 대한 포인터입니다. 배열의 각 구조체는 정렬 키로 사용할 특성의 이름, 해당 키에 대한 일치 규칙 및 정렬 순서가 오름차순인지 또는 내림차순인지를 지정합니다.
[in] IsCritical
이 컨트롤이 검색에 중요한지 여부를 서버에 알릴 수 있습니다. 0 ==> FALSE, !0 ==> TRUE입니다.
[out] Control
새로 만든 컨트롤에 대한 포인터입니다.
반환 값
이 함수는 WINLDAPAPI ULONG LDAPAPI를 반환합니다.
발언
ldap_create_sort_control 함수는 기본 정렬 컨트롤을 만듭니다. 이러한 컨트롤은 LDAP 클라이언트에 제한된 기능이 있고 결과를 정렬할 수 없지만 정렬해야 하는 경우에 유용합니다.
정렬 컨트롤을 사용하면 서버가 검색 작업에 대해 반환된 결과 코드와 독립적인 결과 정렬에 대한 결과 코드를 반환할 수 있습니다.
이 함수는 컨트롤을 만듭니다. 서버가 컨트롤을 지원하는지 확인하지 않으므로 서버가 컨트롤을 지원하지 않는 경우 LDAP_UNAVAILABLE_CRIT_EXTENSION 반환하지 않습니다. 그러나 LDAP_NO_MEMORY 또는 LDAP_PARAM_ERROR 같은 다른 표준 LDAP 반환 값을 반환할 수 있습니다.
더 이상 필요하지 않은 컨트롤을 해제하려면 ldap_control_free호출합니다.
메모
winldap.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 ldap_create_sort_control 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | winldap.h |
| 라이브러리 | Wldap32.lib |
| DLL | Wldap32.dll |