ldap_add_ext_s 함수(winldap.h)

아티클
03/13/2024

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

구문

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

매개 변수

[in] ld

세션 핸들입니다.

[in] dn

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

[in] attrs

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

[in] ServerControls

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

[in] ClientControls

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

반환 값

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

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

설명

ldap_add_ext_s 매개 변수와 효과에는 ldap_add_s 매개 변수가 포함됩니다. 확장 루틴에는 클라이언트 및 서버 컨트롤을 지원하는 추가 매개 변수가 포함됩니다.

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

추가 작업이 완료되면 ldap_add_ext_s 호출자에게 돌아갑니다. 작업을 비동기적으로 완료하려면 ldap_add_ext 사용합니다.

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

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

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

요구 사항

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