Estructura LDAP (winldap.h)

Artículo
03/13/2024

La estructura LDAP representa una sesión LDAP. Normalmente, una sesión corresponde a una conexión a un único servidor. Sin embargo, en el caso de las referencias, una sesión LDAP puede abarcar varias conexiones de servidor. La capacidad de realizar un seguimiento de las referencias está disponible en LDAP 3.

Sintaxis

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;

Miembros

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

Comentarios

Una estructura LDAP es un tipo de datos opaco asignado e inicializado por una llamada a ldap_init, cldap_open o ldap_open. Las llamadas LDAP posteriores pasan un identificador a esta estructura, que mantiene el estado de una sesión LDAP durante la duración de la conexión. Cuando finalice la sesión, llame a ldap_unbind para destruir el identificador de conexión.

Aunque se trata de un tipo de datos opaco, se documenta en Winldap.h. Esto es principalmente de valor en la portabilidad de aplicaciones escritas mediante otras implementaciones de cliente LDAP. Llame a ldap_get_option o ldap_set_option para acceder o cambiar los valores asociados al identificador de conexión LDAP (esta estructura). El uso de estas dos funciones también expone la configuración no accesible directamente desde la estructura LDAP . Para obtener más información sobre las opciones de sesión, consulte Opciones de sesión.