ldap_first_attribute 함수(winldap.h)
지정된 디렉터리 항목의 경우 ldap_first_attribute 함수는 첫 번째 특성을 반환합니다.
구문
WINLDAPAPI PCHAR LDAPAPI ldap_first_attribute(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[out] BerElement **ptr
);
매개 변수
[in] ld
세션 핸들입니다.
[in] entry
ldap_first_entry 또는ldap_next_entry 반환된 대로 특성을 단계별로 처리할 항목입니다.
[out] ptr
항목의 현재 위치를 추적하는 데 내부적으로 사용되는 포인터의 주소입니다.
반환 값
null로 끝나는 문자열에 대한 포인터입니다. 함수가 성공하면 현재 특성 이름이 포함된 할당된 버퍼에 대한 포인터를 반환합니다. 단계별로 실행할 특성이 더 이상 없으면 NULL을 반환합니다. LDAP 데이터 구조의 세션 오류 매개 변수는 두 경우 모두 0으로 설정됩니다.
함수가 실패하면 NULL 을 반환하고 LDAP 데이터 구조의 세션 오류 매개 변수를 LDAP 오류 코드로 설정합니다.
설명
ldap_next_attribute 함께 ldap_first_attribute 사용하여 항목과 함께 반환된 특성 형식 목록을 단계별로 진행합니다. 그런 다음 ldap_get_values 호출에서 이러한 특성 이름을 전달하여 연결된 값을 검색할 수 있습니다.
ldap_first_attribute 호출은 BerElement 구조체에 대한 포인터인 ptr 매개 변수를 통해 를 할당하고 반환합니다. 이 포인터를 ldap_next_attribute 전달하여 특성 목록에서 현재 위치를 추적합니다. 특성 목록을 단계별로 실행한 후 ptr 이 NULL이 아닌 경우 ber_free( ptr, 0 )를 호출하여 포인터를 해제합니다. 이 호출에서 두 번째 매개 변수를 0으로 전달해야 합니다.
ldap_first_attribute 및 ldap_next_attribute 모두 현재 특성 이름을 포함하는 할당된 버퍼에 대한 포인터를 반환합니다. 더 이상 필요하지 않은 경우 ldap_memfree 호출하여 이 버퍼를 해제합니다. 이 버퍼는 ldap_first_attribute 또는 에 대한 다음 호출에서 덮어쓰기 때문입니다.
ldap_next_attribute 처리를 위해 보존해야 하는 경우 사용자는 특성 이름의 복사본을 만들어야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | winldap.h |
| 라이브러리 | Wldap32.lib |
| DLL | Wldap32.dll |