Структура LDAP (winldap.h)

Статья
03/04/2024

Структура 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;
} 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

Структура LDAP — это непрозрачный тип данных, выделенный и инициализированный вызовом ldap_init, cldap_open или ldap_open. Последующие вызовы LDAP передают дескриптор этой структуре, которая поддерживает состояние сеанса LDAP на протяжении всего соединения. После завершения сеанса вызовите ldap_unbind , чтобы уничтожить дескриптор подключения.

Хотя это непрозрачный тип данных, он задокументирован в Winldap.h. Это в первую очередь важно при переносе приложений, написанных с помощью других реализаций клиента LDAP. Вызовите ldap_get_option или ldap_set_option для доступа или изменения значений, связанных с дескриптором подключения LDAP (эта структура). Использование этих двух функций также предоставляет параметры, недоступные напрямую из структуры LDAP . Дополнительные сведения о параметрах сеанса см. в разделе Параметры сеанса.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Верхняя часть	winldap.h