ldap_add_ext 함수(winldap.h)

아티클
08/27/2023

ldap_add_ext 함수는 트리에 비동기 추가 작업을 시작합니다. 추가된 항목의 부모가 있어야 하거나 추가 작업이 성공하려면 부모가 비어 있어야 합니다(루트의 고유 이름과 동일).

구문

WINLDAPAPI ULONG LDAPAPI ldap_add_ext(
  [in]  LDAP          *ld,
  [in]  const PSTR    dn,
  [in]  LDAPModA * [] attrs,
  [in]  PLDAPControlA *ServerControls,
  [in]  PLDAPControlA *ClientControls,
  [out] ULONG         *MessageNumber
);

매개 변수

[in] ld

세션 핸들입니다.

[in] dn

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

[in] attrs

LDAPMod 구조체에 대한 포인터 배열입니다. 각 구조체는 단일 특성을 지정합니다. 자세한 내용은 주의 섹션을 참조하세요.

[in] ServerControls

LDAP 서버 컨트롤 목록입니다.

[in] ClientControls

클라이언트 컨트롤 목록입니다.

[out] MessageNumber

요청에 대한 메시지 ID입니다.

반환 값

함수가 성공하면 LDAP_SUCCESS 반환됩니다.

함수가 실패하면 오류 코드가 반환됩니다. 자세한 내용은 오류 처리를 참조하세요.

설명

ldap_add_ext 매개 변수 및 효과에는 ldap_add 매개 변수가 포함됩니다. 확장 루틴에는 클라이언트 및 서버 컨트롤과 스레드 보안을 지원하는 추가 매개 변수가 포함됩니다.

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

작업이 성공하면 ldap_add_ext 메시지 ID를 호출자에게 매개 변수로 전달합니다. 메시지 ID를 사용하여 ldap_result 호출하여 작업 결과를 가져옵니다.

결과가 직접 반환되도록 하려면 동기 함수 ldap_add_ext_s 사용합니다.

다중 스레드: ldap_add_ext 대한 호출은 스레드로부터 안전합니다.

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

ServerControls 및 ClientControls 는 선택 사항이며 사용하지 않는 경우 NULL 로 설정해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	winldap.h
라이브러리	Wldap32.lib
DLL	Wldap32.dll