Estrutura LDAP (winldap.h)

Artigo
03/16/2023

A estrutura LDAP representa uma sessão LDAP. Normalmente, uma sessão corresponde a uma conexão com um único servidor. No entanto, no caso de indicações, uma sessão LDAP pode abranger várias conexões de servidor. A capacidade de rastrear indicações está disponível no LDAP 3.

Sintaxe

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;

Membros

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

Comentários

Uma estrutura LDAP é um tipo de dados opaco alocado e inicializado por uma chamada para ldap_init, cldap_open ou ldap_open. Chamadas LDAP subsequentes passam um identificador para essa estrutura, que mantém o estado de uma sessão LDAP durante a conexão. Quando a sessão terminar, chame ldap_unbind para destruir o identificador de conexão.

Embora esse seja um tipo de dados opaco, ele está documentado em Winldap.h. Isso é principalmente de valor na portabilidade de aplicativos gravados usando outras implementações de cliente LDAP. Chame ldap_get_option ou ldap_set_option para acessar ou alterar os valores associados ao identificador de conexão LDAP (essa estrutura). O uso dessas duas funções também expõe configurações não acessíveis diretamente da estrutura LDAP . Para obter mais informações sobre as opções de sessão, consulte Opções de sessão.