Struttura LDAP (winldap.h)

Articolo
03/16/2023

La struttura LDAP rappresenta una sessione LDAP . In genere, una sessione corrisponde a una connessione a un singolo server. Tuttavia, nel caso di segnalazioni, una sessione LDAP può includere diverse connessioni server. La possibilità di tenere traccia delle segnalazioni è disponibile in LDAP 3.

Sintassi

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;

Members

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

Commenti

Una struttura LDAP è un tipo di dati opaco allocato e inizializzato da una chiamata a ldap_init, cldap_open o ldap_open. Le chiamate LDAP successive passano un handle a questa struttura, che mantiene lo stato di una sessione LDAP per la durata della connessione. Al termine della sessione, chiamare ldap_unbind per eliminare l'handle di connessione.

Anche se si tratta di un tipo di dati opaco, è documentato in Winldap.h. Si tratta principalmente di valore nelle applicazioni di conversione scritte usando altre implementazioni client LDAP. Chiamare ldap_get_option o ldap_set_option per accedere o modificare i valori associati all'handle di connessione LDAP (questa struttura). L'uso di queste due funzioni espone anche le impostazioni non direttamente accessibili dalla struttura LDAP . Per altre informazioni sulle opzioni di sessione, vedere Opzioni sessione.