Structure LDAP (winldap.h)

Article
03/13/2024

La structure LDAP représente une session LDAP. En règle générale, une session correspond à une connexion à un serveur unique. Toutefois, dans le cas de références, une session LDAP peut englober plusieurs connexions de serveur. La possibilité de suivre les références est disponible dans LDAP 3.

Syntaxe

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;
} LDAP, *PLDAP;

Membres

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

Remarques

Une structure LDAP est un type de données opaque alloué et initialisé par un appel à ldap_init, cldap_open ou ldap_open. Les appels LDAP suivants passent un handle à cette structure, qui conserve l’état d’une session LDAP pendant la durée de la connexion. Lorsque la session se termine, appelez ldap_unbind pour détruire le handle de connexion.

Bien qu’il s’agisse d’un type de données opaque, il est documenté dans Winldap.h. Il s’agit principalement d’une valeur dans le portage d’applications écrites à l’aide d’autres implémentations de client LDAP. Appelez ldap_get_option ou ldap_set_option pour accéder ou modifier les valeurs associées au handle de connexion LDAP (cette structure). L’utilisation de ces deux fonctions expose également les paramètres qui ne sont pas directement accessibles à partir de la structure LDAP . Pour plus d’informations sur les options de session, consultez Options de session.