ldap_add 함수(winldap.h)

ldap_add 함수는 디렉터리 트리에 비동기 추가 작업을 시작합니다. 추가 작업이 성공하려면 추가된 항목의 부모가 있어야 합니다. 그렇지 않으면 부모가 비어 있어야 합니다(루트의 고유 이름과 같음).

구문

WINLDAPAPI ULONG LDAPAPI ldap_add(
  [in] LDAP         *ld,
  [in] PSTR         dn,
  [in] LDAPMod * [] attrs
);

[in] ld

세션 핸들입니다.

[in] dn

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

[in] attrs

LDAPMod 구조체에 대한 포인터 배열입니다. 각 구조체는 단일 특성을 지정합니다.

함수가 성공하면 추가 작업의 메시지 ID가 반환됩니다.

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

ldap_add 호출하기 전에 LDAPMod 구조체에서 해당 특성을 지정하여 항목을 만듭니다. 각 구조체의 mod_op 멤버를 LDAP_MOD_ADD 설정하고 mod_type 및 mod_vals 멤버를 항목에 적절하게 설정합니다.

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

결과가 직접 반환되도록 하려면 동기 함수 ldap_add_s 사용합니다. ldap_add_ext 또는 ldap_add_ext_s 사용하여 LDAP 3 서버 및 클라이언트 컨트롤에 대한 지원을 사용하도록 설정합니다.

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

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