LDAPControlA 구조체(winldap.h)

LDAPControl 구조체는 클라이언트 쪽 및 서버 컨트롤을 모두 나타냅니다.

통사론

typedef struct ldapcontrolA {
  PCHAR         ldctl_oid;
  struct berval ldctl_value;
  BOOLEAN       ldctl_iscritical;
} LDAPControlA, *PLDAPControlA;

회원

ldctl_oid

컨트롤 형식(예: "1.2.840.113556.1.4.805")을 나타내는 null로 끝나는 와이드 문자열에 대한 포인터입니다.

ldctl_value

컨트롤과 연결된 데이터(있는 경우)입니다. 컨트롤과 연결된 데이터가 없으면 이 멤버를 NULL설정합니다.

ldctl_iscritical

중요도 필드라고 하는 컨트롤이 중요한지 여부를 나타냅니다.

발언

LDAP 3부터는 컨트롤을 사용하여 LDAP 작업을 확장할 수 있습니다. 서버 컨트롤을 서버로 보내거나 LDAP 메시지와 함께 클라이언트로 반환할 수 있습니다. 클라이언트 컨트롤은 클라이언트 쪽에서만 LDAP API의 동작을 확장하며 서버로 전송되지 않습니다. 지원되는 컨트롤은 디렉터리 서비스 루트에 OID(개체 식별자)로 저장됩니다.

ldctl_iscritical 멤버를 사용하면 서버 또는 클라이언트가 컨트롤을 지원하지 않을 때 확장 작업이 성공할 수 있습니다. 이 필드의 값이 0이면 서버 및/또는 클라이언트가 지원되지 않는 경우 컨트롤을 무시하고 작업을 수행합니다. 값이 0이 아니면 서버 및/또는 클라이언트에서 컨트롤을 인식하는 경우에만 작업이 수행됩니다.

자세한 내용 및 지원되는 LDAP 확장 컨트롤 및 해당 설명 목록은 확장 컨트롤참조하세요.

메모

winldap.h 헤더는 LDAPControl을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
헤더	winldap.h

참고 항목

데이터 구조

LDAPMessage

컨트롤 사용하는