ldap_get_values 함수(winldap.h)
ldap_get_values 함수는 지정된 특성의 값 목록을 검색합니다.
구문
WINLDAPAPI PCHAR *LDAPAPI ldap_get_values(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[in] const PSTR attr
);
매개 변수
[in] ld
세션 핸들입니다.
[in] entry
값을 검색할 항목입니다.
[in] attr
값을 검색할 특성이 포함된 null로 끝나는 문자열에 대한 포인터입니다.
반환 값
함수가 성공하면 값에 대한 null로 끝나는 포인터 목록을 반환합니다. 특성 값이 없으면 일반적으로 NULL을 반환합니다. 그러나 경우에 따라 NULL인 하나의 포인터 목록을 반환할 수 있습니다. 설명에 설명된 대로 항상 ldap_count_values 사용하여 반환된 목록의 값 수를 가져와야 합니다. LDAP 데이터 구조의 세션 오류 매개 변수는 두 경우 모두 0으로 설정됩니다.
함수가 실패하면 NULL 이 반환되고 LDAP 데이터 구조의 세션 오류 매개 변수가 LDAP 오류 코드로 설정됩니다.
설명
검색 응답을 구문 분석할 때 ldap_get_values 사용하여 특성의 값 또는 값을 가져옵니다. 특성에 null로 끝나는 문자열이 포함된 경우에만 이 함수를 사용합니다. 이진 데이터의 경우 대신 ldap_get_values_len 사용합니다.
항목은 ldap_first_entry 또는 ldap_next_entry 호출하여 가져옵니다. 특성은 ldap_first_attribute, ldap_next_attribute 또는 호출자가 제공한 문자열(예: "mail")에 대한 호출로 반환되어야 합니다.
ldap_count_values 사용하여 반환된 목록의 값 수를 가져옵니다. 더 이상 필요하지 않은 경우 ldap_value_free 호출하여 반환된 값을 해제합니다.
특정 LDAP 서버는 단일 호출에서 반환되는 특성 문자열 값의 수에 제한을 줍니다. 범위 검색 지정자를 사용하는 방법에 대한 자세한 내용은 범위 검색을 사용하여 검색을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | winldap.h |
| 라이브러리 | Wldap32.lib |
| DLL | Wldap32.dll |