通过

LDAPControlA 结构 （winldap.h）

  • 项目

LDAPControl 结构表示客户端控件和服务器控件。

语法

typedef struct ldapcontrolA {
  PCHAR         ldctl_oid;
  struct berval ldctl_value;
  BOOLEAN       ldctl_iscritical;
} LDAPControlA, *PLDAPControlA;

成员

ldctl_oid

指向指示控件类型的宽、以 null 结尾的字符串的指针，例如“1.2.840.113556.1.4.805”。

ldctl_value

与控件关联的数据（如果有）。 如果没有与控件关联的数据，请将此成员设置为 NULL。

ldctl_iscritical

指示控件是否关键，称为“关键性”字段。

言论

通过 LDAP 3，可以通过使用控件来扩展 LDAP 操作。 服务器控件可以发送到服务器，也可以返回给客户端，其中包含任何 LDAP 消息。 客户端控件仅扩展客户端上的 LDAP API 的行为，并且永远不会发送到服务器。 支持的控件作为对象标识符（OID）存储在目录服务根目录中。

当服务器或客户端不支持该控件时，ldctl_iscritical 成员允许扩展操作成功。 如果此字段的值为零，则服务器和/或客户端将忽略控件（如果不支持）并执行该操作。 如果值为非零，则仅当服务器和/或客户端识别控件时，才会执行操作。

有关详细信息，以及支持的 LDAP 扩展控件及其说明的列表，请参阅 扩展控件。

注意

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

要求

要求 价值
最低支持的客户端 Windows Vista
支持的最低服务器 Windows Server 2008
标头 winldap.h

另请参阅

数据结构

LDAPMessage

使用控件