다음을 통해 공유

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
머리글 winldap.h

추가 정보

데이터 구조

LDAPMessage

컨트롤 사용