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) 将带来相同的优势，但需要为服务器注册大量证书，有时还需要为客户端注册证书。

若要启用签名和密封，必须在使用绑定方法LDAP_AUTH_NEGOTIATE调用ldap_bind_s之前打开以下选项之一。

#define LDAP_OPT_SIGN      0x95
#define LDAP_OPT_ENCRYPT   0x96

若要关闭签名和密封，请通过调用连接句柄上的 ldap_unbind () 来关闭连接。

多线程处理：调用 ldap_set_option 不安全，因为它会影响整个连接。如果线程共享连接，请小心。

返回值