LDAP-Struktur (winldap.h)

Artikel
03/06/2024

Die LDAP-Struktur stellt eine LDAP-Sitzung dar. In der Regel entspricht eine Sitzung einer Verbindung mit einem einzelnen Server. Bei Verweisen kann eine LDAP-Sitzung jedoch mehrere Serververbindungen umfassen. Die Möglichkeit zum Nachverfolgen von Empfehlungen ist in LDAP 3 verfügbar.

Syntax

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;

Member

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

Hinweise

Eine LDAP-Struktur ist ein undurchsichtiger Datentyp, der durch einen Aufruf von ldap_init, cldap_open oder ldap_open zugeordnet und initialisiert wird. Nachfolgende LDAP-Aufrufe übergeben ein Handle an diese Struktur, das den Zustand einer LDAP-Sitzung für die Dauer der Verbindung beibehält. Wenn die Sitzung endet, rufen Sie ldap_unbind auf, um das Verbindungshandle zu zerstören.

Obwohl dies ein undurchsichtiger Datentyp ist, ist er in Winldap.h dokumentiert. Dies ist in erster Linie beim Portieren von Anwendungen von Nutzen, die mit anderen LDAP-Clientimplementierungen geschrieben wurden. Rufen Sie ldap_get_option oder ldap_set_option auf, um auf die Werte zuzugreifen oder diese zu ändern, die dem LDAP-Verbindungshandle (diese Struktur) zugeordnet sind. Mithilfe dieser beiden Funktionen werden auch Einstellungen verfügbar gemacht, auf die nicht direkt über die LDAP-Struktur zugegriffen werden kann. Weitere Informationen zu Sitzungsoptionen finden Sie unter Sitzungsoptionen.