LDAP 結構 (winldap.h)

發行項
03/09/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 結構存取的設定。如需會話選項的詳細資訊，請參閱會話選項。