ldap_create_vlv_controlA函数（winldap.h）

2024-11-20

ldap_create_vlv_control 函数用于在服务器上创建请求控件（LDAP_CONTROL_VLVREQUEST）。

语法

WINLDAPAPI INT LDAPAPI ldap_create_vlv_controlA(
  [in]  PLDAP         ExternalHandle,
  [in]  PLDAPVLVInfo  VlvInfo,
  [in]  UCHAR         IsCritical,
  [out] PLDAPControlA *Control
);

参数

[in] ExternalHandle

从调用 ldap_init获取的 LDAP 会话句柄。

[in] VlvInfo

LDAPVLVInfo 结构的地址，其内容用于构造所创建的控件的值。

[in] IsCritical

如果此值不为零，则创建的控件的严重性将设置为 TRUE。

[out] Control

结果参数分配了包含此函数创建的请求控件（LDAP_CONTROL_VLVREQUEST）的 LDAPControl 结构的地址。

返回值

ldap_create_vlv_control 函数返回 LDAP 错误代码，指示失败，或LDAP_SUCCESS成功。

言论

执行 VLV 搜索时，客户端必须使用此函数创建一个新的 VLV 控件，该控件可以包含在发送到服务器的搜索请求中。服务器将为传递给客户端的此 VLV 搜索分配 contextID。完成 VLV 搜索后，应使用 ldap_control_free 释放 ldap_create_vlv_control返回的控件，并 ldap_controls_free 释放由 ldap_parse_result返回的控件数组（包括 VLV 响应控件）。

有关详细信息，以及此函数的代码示例，请参阅使用 LDAP VLV的示例代码。

注意

winldap.h 标头将ldap_create_vlv_control定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求

要求	价值
最低支持的客户端	Windows Vista
支持的最低服务器	Windows Server 2008
目标平台	窗户
标头	winldap.h
库	Wldap32.lib
DLL	Wldap32.dll