ldap_modify 함수(winldap.h)

ldap_modify 함수는 기존 항목을 변경합니다.

구문

WINLDAPAPI ULONG LDAPAPI ldap_modify(
  [in] LDAP          *ld,
  [in] PSTR          dn,
  [in] LDAPModA * [] mods
);

[in] ld

세션 핸들입니다.

[in] dn

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

[in] mods

항목에 대해 수정할 null로 종료된 배열입니다.

함수가 성공하면 수정 작업의 메시지 ID를 반환합니다.

함수가 실패하면 –1을 반환하고 LDAP 데이터 구조에서 세션 오류 매개 변수를 설정합니다.

ldap_modify 함수는 비동기 작업을 시작하여 기존 항목을 수정합니다. 값이 항목에 추가되거나 대체되는 경우 함수는 필요한 경우 특성을 만듭니다. 값이 삭제되고 값이 남아 있지 않으면 함수는 특성을 제거합니다. 모든 수정은 나열된 순서대로 수행됩니다.

비동기 함수인 ldap_modify 작업에 대한 메시지 ID를 반환합니다. 메시지 ID를 사용하여 ldap_result 호출하여 작업 결과를 가져옵니다. 비동기 작업이 완료되기 전에 취소하려면 ldap_abandon 호출합니다.

함수가 결과를 직접 반환하도록 하려면 동기 루틴 ldap_modify_s 사용합니다. LDAP 3 서버 및 클라이언트 컨트롤에 대한 지원이 필요한 경우 ldap_modify_ext 또는 ldap_modify_ext_s 사용합니다.

다중 스레딩: 함수 호출이 -1 오류 코드를 반환할 때 LdapGetLastError 를 사용하여 실제 세션 오류 코드를 검색하는 경우 ldap_modify 호출은 스레드로부터 안전합니다.

참고 LDAP 2 서버에 연결할 때 애플리케이션은 다른 작업을 시도하기 전에 바인딩 작업을 수행해야 합니다( ldap_bind 또는 ldap_simple_bind 루틴 중 하나를 호출).