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 구조에서 직접 액세스할 수 없는 설정도 노출됩니다. 세션 옵션에 대한 자세한 내용은 세션 옵션을 참조하세요.