LDAPModA 구조체(winldap.h)

아티클
03/04/2024

LDAPMod 구조체는 수정 작업을 수행하는 데 필요한 데이터를 보유합니다.

구문

typedef struct ldapmodA {
  ULONG mod_op;
  PCHAR mod_type;
  union {
    PCHAR  *modv_strvals;
    berval **modv_bvals;
  } mod_vals;
} LDAPModA, *PLDAPModA;

멤버

mod_op

수행할 수정 작업을 나타내는 다음 값 중 하나를 지정합니다.

비트 OR 연산자를 사용하여 작업 값을 LDAP_MOD_BVALUES 결합하여 mod_vals 공용 구조체가 modv_bvals 멤버를 사용함을 나타낼 수 있습니다. LDAP_MOD_BVALUES 설정되지 않은 경우 공용 구조체는 modv_strvals 멤버를 사용합니다.

LDAP_MOD_ADD(0x00)

항목에 값을 추가합니다. 제공된 값은 특성의 기존 값에 추가됩니다.

LDAP_MOD_DELETE(0x01)

항목의 값을 삭제합니다. 제공된 값은 현재 특성 값에서 삭제됩니다.

LDAP_MOD_REPLACE(0x02)

항목의 값을 바꿉니다. 제공된 값은 기존 특성 값을 대체합니다.

mod_type

수정할 특성의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.

mod_vals

추가, 삭제 또는 바꿀 값 배열(있는 경우)에 대한 포인터입니다. mop_op LDAP_MOD_BVALUES 플래그를 포함하지 않는 경우 modv_strvals 멤버는 null로 끝나는 문자열 배열에 대한 포인터입니다. mop_op LDAP_MOD_BVALUES 포함하는 경우 modv_bvals 멤버는 이진 값을 지정하는 데 유용한 berval 포인터 배열에 대한 포인터입니다.

mod_vals.modv_strvals

null로 종료된 문자열의 null로 끝나는 배열에 대한 포인터입니다. 배열의 마지막 요소는 NULL 포인터여야 합니다.

mod_vals.modv_bvals

버벌 포인터의 NULL로 끝나는 배열에 대한 포인터입니다. 배열의 마지막 요소는 NULL 포인터여야 합니다.

설명

수정 함수(ldap_add*또는 ldap_modify*)를 호출하기 전에 LDAPMod 구조체의 필드에 값을 할당합니다.

LDAP_MOD_REPLACE 연산을 사용하는 ldap_modify *는 null 포인터를 전달할 때 특성을 삭제하지 않습니다. 그러나 LDAP_MOD_DELETE mod_valsNULL로 설정된 경우 전체 특성을 삭제합니다.

LDAPMod 구조를 ldap_add* 함수에 전달하는 경우 LDAP_MOD_BVALUES 플래그만 중요합니다. 새 개체를 만들면 값이 추가됩니다.

참고

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