ldap_connect 함수(winldap.h)
ldap_connect 함수는 서버와의 연결을 설정합니다.
구문
WINLDAPAPI ULONG LDAPAPI ldap_connect(
[in] LDAP *ld,
[in] l_timeval *timeout
);
매개 변수
[in] ld
ldap_init 가져온 세션 핸들입니다.
[in] timeout
시간 제한 전에 연결을 설정하는 데 소요되는 시간(초)을 지정하는 LDAP_TIMEVAL 구조체에 대한 포인터입니다. NULL인 경우 함수는 기본 시간 제한 값을 사용합니다.
반환 값
함수가 성공하면 LDAP_SUCCESS 반환됩니다.
함수가 실패하면 오류 코드가 반환됩니다. 자세한 내용은 반환 값을 참조하세요.
설명
클라이언트 호출이 서버에 대한 연결을 설정하기 위해 ldap_connect 필요는 없지만 이를 수행하는 것이 좋습니다. 연결이 없으면 다른 함수(예: ldap_bind_s)가 내부적으로 호출을 수행합니다. 그러나 애플리케이션의 이 부분을 해결해야 하는 경우 다른 함수(예: ldap_bind_s)를 호출하기 전에 연결을 설정하면 연결이 실패할 경우 가능한 문제도 구분됩니다. 또는 연결 블록에 추가 옵션을 지정할 수 있습니다. 예를 들어 클라이언트는 ldap_init 호출하여 세션을 초기화한 다음 NULL이 아닌 시간 제한 매개 변수 값으로 ldap_connect 호출하여 지정된 시간 제한으로 서버에 연결할 수 있습니다.
ldap_connect 호출이 성공하면 클라이언트는 익명 사용자로 LDAP 서버에 연결됩니다. 세션 핸들은 더 이상 필요하지 않은 경우 ldap_unbind 호출하여 해제해야 합니다.
ldap_connect 호출이 실패하면 오류 복구에 더 이상 필요하지 않은 경우 ldap_unbind 대한 호출로 세션 핸들을 해제해야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | winldap.h |
| 라이브러리 | Wldap32.lib |
| DLL | Wldap32.dll |