ldap 结构 (winldap.h)

2024-03-13

LDAP 结构表示 LDAP 会话。通常，会话对应于与单个服务器的连接。但是，在引荐的情况下，LDAP 会话可能包含多个服务器连接。 LDAP 3 中提供了跟踪引荐的功能。

语法

typedef struct ldap {
  struct {
    UINT_PTR  sb_sd;
    UCHAR     *Reserved1[(10  sizeof(ULONG))+ 1];
    ULONG_PTR sb_naddr;
    UCHAR     *Reserved2[(6  sizeof(ULONG))];
  } ld_sb;
  PCHAR  ld_host;
  ULONG  ld_version;
  UCHAR  ld_lberoptions;
  ULONG  ld_deref;
  ULONG  ld_timelimit;
  ULONG  ld_sizelimit;
  ULONG  ld_errno;
  PCHAR  ld_matched;
  PCHAR  ld_error;
  ULONG  ld_msgid;
  UCHAR  *Reserved3[(6  sizeof(ULONG))+ 1];
  ULONG  ld_cldaptries;
  ULONG  ld_cldaptimeout;
  ULONG  ld_refhoplimit;
  ULONG  ld_options;
  ULONG  ld_maxvalrange;
} LDAP, *PLDAP;

成员

ld_sb

ld_sb.sb_sd

ld_sb.Reserved1[(10 * sizeof(ULONG))+ 1]

ld_sb.sb_naddr

ld_sb.Reserved2[(6 * sizeof(ULONG))]

ld_host

ld_version

ld_lberoptions

ld_deref

ld_timelimit

ld_sizelimit

ld_errno

ld_matched

ld_error

ld_msgid

Reserved3[(6 * sizeof(ULONG))+ 1]

ld_cldaptries

ld_cldaptimeout

ld_refhoplimit

ld_options

ld_maxvalrange

注解

LDAP 结构是通过调用 ldap_init、cldap_open 或 ldap_open 分配和初始化的不透明数据类型。后续 LDAP 调用将句柄传递给此结构，该结构在连接期间维护 LDAP 会话的状态。会话结束时，调用 ldap_unbind 销毁连接句柄。

虽然这是一种不透明的数据类型，但它在 Winldap.h 中进行了记录。这主要适用于移植使用其他 LDAP 客户端实现编写的应用程序。调用 ldap_get_option 或 ldap_set_option 来访问或更改与此结构) (LDAP 连接句柄关联的值。使用这两个函数还会公开无法从 LDAP 结构直接访问的设置。有关会话选项的详细信息，请参阅会话选项。