Struktur LDAP (winldap.h)

Artikel
03/04/2024

Struktur LDAP mewakili sesi LDAP. Biasanya, sesi sesuai dengan koneksi ke satu server. Namun, dalam kasus rujukan, sesi LDAP dapat mencakup beberapa koneksi server. Kemampuan untuk melacak rujukan tersedia di LDAP 3.

Sintaks

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;

Anggota

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

Keterangan

Struktur LDAP adalah jenis data buram yang dialokasikan dan diinisialisasi oleh panggilan ke ldap_init, cldap_open, atau ldap_open. Panggilan LDAP berikutnya meneruskan handel ke struktur ini, yang mempertahankan status sesi LDAP selama durasi koneksi. Ketika sesi berakhir, panggil ldap_unbind untuk menghancurkan handel koneksi.

Meskipun ini adalah jenis data buram, ini didokumenkan dalam Winldap.h. Ini terutama nilai dalam aplikasi porting yang ditulis menggunakan implementasi klien LDAP lainnya. Panggil ldap_get_option atau ldap_set_option untuk mengakses atau mengubah nilai yang terkait dengan handel koneksi LDAP (struktur ini). Menggunakan kedua fungsi ini juga mengekspos pengaturan yang tidak dapat diakses langsung dari struktur LDAP . Untuk informasi selengkapnya tentang opsi sesi, lihat Opsi Sesi.