ldap_get_values_len 함수(winldap.h)

ldap_get_values_len 함수는 지정된 특성의 값 목록을 검색합니다.

구문

WINLDAPAPI berval **LDAPAPI ldap_get_values_len(
  [in] LDAP        *ExternalHandle,
  [in] LDAPMessage *Message,
  [in] const PSTR  attr
);

[in] ExternalHandle

세션 핸들입니다.

[in] Message

LDAPMessage 구조체에 대한 핸들입니다.

[in] attr

값을 검색할 특성이 포함된 null로 끝나는 문자열에 대한 포인터입니다.

함수가 성공하면 지정된 특성의 값이 포함된 berval 구조체에 대한 null로 끝나는 포인터 목록을 반환합니다. 특성 값이 없으면 NULL을 반환합니다. LDAP 데이터 구조의 세션 오류 매개 변수는 두 경우 모두 0으로 설정됩니다.

함수가 실패하면 NULL 이 반환되고 LDAP 데이터 구조의 세션 오류 매개 변수가 LDAP 오류 코드로 설정됩니다.

검색 응답을 구문 분석할 때 ldap_get_values_len 사용하여 특성의 값 또는 값을 가져옵니다. 특성에 이진 데이터가 포함된 경우 이 함수를 사용합니다. 값이 null로 끝나는 문자열인 특성의 경우 ldap_get_values 사용합니다.

항목은 ldap_first_entry 또는 ldap_next_entry 호출하여 가져옵니다. 특성은 ldap_first_attribute, ldap_next_attribute 또는 호출자가 제공한 문자열(예: "mail")에 대한 호출로 반환되어야 합니다.

더 이상 필요하지 않은 경우 ldap_value_free_len 호출하여 반환된 값을 해제합니다.