ldap_result 函数 (winldap.h)
ldap_result 函数获取异步操作的结果。
语法
WINLDAPAPI ULONG LDAPAPI ldap_result(
[in] LDAP *ld,
[in] ULONG msgid,
[in] ULONG all,
[in] PLDAP_TIMEVAL timeout,
[out] PLDAPMessage *res
);
参数
[in] ld
会话句柄。
[in] msgid
操作的消息 ID 或常量LDAP_RES_ANY（如果需要任何结果）。
[in] all
指定在对 ldap_result的单个调用中检索的消息数。 此参数仅对搜索结果有意义。 传递常量LDAP_MSG_ONE (0x00) 一次检索一条消息。 传递LDAP_MSG_ALL (0x01) 以请求在返回单个链中的所有结果之前接收所有搜索结果。 传递LDAP_MSG_RECEIVED (0x02) 指示到目前为止检索到的所有结果都应在结果链中返回。
[in] timeout
一个超时值，指定等待返回结果的时间（以秒为单位）。 NULL 值会导致ldap_result阻塞，直到结果可用。 超时值零秒指定轮询行为。
[out] res
包含操作 () 的结果。 应用程序不再需要返回的任何结果后，应通过调用 ldap_msgfree 来释放这些结果。
返回值
如果函数成功，它将返回以下值之一，以指示 res 参数中第一个结果的类型。 如果超时过期，该函数将返回 0。
如果函数失败，它将返回 –1 并在 LDAP 数据结构中设置会话错误参数。
注解
ldap_result函数检索先前异步启动的操作的结果。 请注意，根据调用方式， ldap_result 实际上可能会返回消息列表或“链”。
对于无连接 LDAP，必须同时传递 LDAP 连接句柄和消息 ID，以确保获得正确的结果。 LDAP 运行时继续发送请求，直到收到响应。
多线程处理：对 ldap_result 的调用是线程安全的。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 目标平台 | Windows |
| 标头 | winldap.h |
| Library | Wldap32.lib |
| DLL | Wldap32.dll |