cldap_open 함수(winldap.h)
cldap_open 함수는 연결 없는 UDP(사용자 데이터그램 프로토콜) 서비스를 통해 LDAP 서버와 세션을 설정합니다. 이는 TCP/IP를 사용하는 대체 항목입니다.
구문
WINLDAPAPI LDAP *LDAPAPI cldap_open(
[in] PSTR HostName,
[in] ULONG PortNumber
);
매개 변수
[in] HostName
LDAP 서버 호스트의 IP 주소를 나타내는 호스트 이름 또는 점선 문자열 목록을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 단일 공간을 사용하여 목록의 호스트 이름을 구분합니다. 목록의 각 호스트 이름 뒤에 포트 번호가 있을 수 있습니다. 선택적 포트 번호는 콜론(:) 호스트 자체와 구분됩니다. LDAP 런타임은 나열된 순서대로 호스트와의 연결을 시도하여 성공적으로 연결되면 중지됩니다.
[in] PortNumber
사용할 포트 번호입니다. 포트 번호를 지정하지 않으면 기본값은 포트 389이며 LDAP_PORT 정의됩니다. 포트 번호가 HostName 매개 변수에 포함된 경우 이 매개 변수는 무시됩니다.
반환 값
함수가 성공하면 LDAP 구조체에 대한 포인터 형식의 세션 핸들이 반환됩니다. 더 이상 필요하지 않은 경우 ldap_unbind 호출하여 세션 핸들을 해제합니다.
함수가 실패하면 반환 값은 NULL입니다. 오류 코드를 얻으려면 LdapGetLastError 또는 Win32 함수 GetLastError를 호출합니다.
설명
cldap_open 함수는 ldap_open 달리 UDP 기반 연결 없는 LDAP 서비스에 대한 연결 블록을 만듭니다. TCP 세션이 유지 관리되지 않습니다. ldap_open 마찬가지로 cldap_open 세션에 대한 상태 데이터를 유지하기 위해 LDAP 구조를 할당한 다음 호출자에게 반환하기 전에 연결을 시도합니다. 호출은 세션 핸들을 반환하며, 세션 과정에서 후속 LDAP 함수 호출에 전달합니다. 세션이 완료되면 항상 ldap_unbind 사용하여 할당된 세션 핸들을 해제합니다.
UDP를 통해 LDAP를 사용하는 것은 바인딩을 지원하지 않으며 TLS(SSL) 또는 SASL을 지원하지 않습니다.
다중 스레딩: cldap_open 대한 호출은 스레드로부터 안전합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | winldap.h |
| 라이브러리 | Wldap32.lib |
| DLL | Wldap32.dll |