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 |