ldap_set_option 함수(winldap.h)
ldap_set_option 함수는 연결 블록에 대한 옵션을 설정합니다. 구조체에 대한 자세한 내용은 데이터 구조를 참조하세요.
구문
WINLDAPAPI ULONG LDAPAPI ldap_set_option(
[in] LDAP *ld,
[in] int option,
[in] const void *invalue
);
매개 변수
[in] ld
세션 핸들입니다.
[in] option
옵션 집합의 이름입니다.
[in] invalue
옵션을 부여할 값에 대한 포인터입니다. 이 매개 변수의 실제 형식은 옵션 매개 변수의 설정에 따라 달라집니다. 설정이 켜지거나 꺼진 옵션에 대해 LDAP_OPT_ON 및 LDAP_OPT_OFF 상수를 지정할 수 있습니다.
반환 값
함수가 성공하면 반환 값이 LDAP_SUCCESS.
함수가 실패하면 오류 코드를 반환합니다. 자세한 내용은 반환 값을 참조하세요.
설명
ldap_set_option 호출하여 LDAP 세션을 나타내는 LDAP 구조체에 액세스합니다. LDAP 데이터 구조를 직접 수정하지 마세요.
LDAP 세션에 적용되는 선택적 설정에 대한 자세한 내용과 설명은 세션 옵션을 참조하세요. 플래그에 대한 자세한 내용은 DsGetDcName을 참조하세요.
이제 Kerberos 인증 프로토콜을 사용하여 Windows LDAP 서버 간에 모든 LDAP 트래픽에 디지털 서명하거나 암호화할 수 있습니다. 이 새로운 기능은 일부 애플리케이션에 필요한 무결성 및 기밀성을 제공합니다. SSL(Secure Sockets Layer)을 사용하면 동일한 이점이 있지만 서버 및 클라이언트에 대한 광범위한 인증서 등록이 필요합니다.
서명 및 봉인을 사용하도록 설정하려면 bind 메서드에 대한 LDAP_AUTH_NEGOTIATE 사용하여 ldap_bind_s 호출하기 전에 다음 옵션 중 하나를 설정해야 합니다.
#define LDAP_OPT_SIGN 0x95
#define LDAP_OPT_ENCRYPT 0x96
서명 및 봉인을 해제하려면 연결 핸들에서 ldap_unbind()를 호출하여 연결을 닫습니다.
다중 스레딩: ldap_set_option 호출은 연결 전체에 영향을 미치기 때문에 안전하지 않습니다. 스레드가 연결을 공유하는 경우 주의해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | winldap.h |
| 라이브러리 | Wldap32.lib |
| DLL | Wldap32.dll |