DsReplicaAddA 함수(ntdsapi.h)
DsReplicaAdd 함수는 대상 명명 컨텍스트에 복제 원본 참조를 추가합니다.
구문
NTDSAPI DWORD DsReplicaAddA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] LPCSTR SourceDsaDn,
[in] LPCSTR TransportDn,
[in] LPCSTR SourceDsaAddress,
[in] const PSCHEDULE pSchedule,
[in] DWORD Options
);
매개 변수
[in] hDS
DSBind 또는 DSBindWithCred 함수에서 가져온 디렉터리 서비스 핸들을 포함합니다.
[in] NameContext
복제본(replica) 추가할 대상 명명 컨텍스트(NC)의 DN(고유 이름)을 지정하는 null로 끝나는 문자열입니다. 대상 NC 레코드는 인스턴스화되거나 인스턴스화되지 않은 개체 또는 참조 가상(예: GUID가 있는 가상)으로 로컬로 존재해야 합니다.
[in] SourceDsaDn
원본 디렉터리 시스템 에이전트에 대한 NTDS-DSA 개체의 DN 을 지정하는 null로 끝나는 문자열입니다. 옵션에 DS_REPADD_ASYNCHRONOUS_REPLICA 포함된 경우 이 매개 변수가 필요합니다. 그렇지 않으면 무시됩니다.
[in] TransportDn
원본 서버와의 통신에 사용되는 전송을 나타내는 interSiteTransport 개체의 DN을 지정하는 null로 끝나는 문자열입니다. 옵션에 DS_REPADD_INTERSITE_MESSAGING 포함되는 경우 이 매개 변수가 필요합니다. 그렇지 않으면 무시됩니다.
[in] SourceDsaAddress
원본 DSA의 전송 관련 주소를 지정하는 null로 끝나는 문자열입니다. 이 원본 서버는 UUID가 아닌 문자열 이름으로 식별됩니다. SourceDsaAddress에 적합한 문자열 이름은 일반적으로 GUID를 기반으로 하는 DNS 이름입니다. 여기서 이름의 GUID 부분은 원본 서버에 대한 NTDS-DSA 개체의 GUID입니다.
[in] pSchedule
복제 원본에 대한 복제 일정 데이터가 포함된 SCHEDULE 구조에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 사용하지 않는 경우 NULL 일 수 있습니다.
[in] Options
요청을 처리하는 데 사용할 추가 데이터를 전달합니다. 이 매개 변수는 다음 값의 조합일 수 있습니다.
DS_REPADD_ASYNCHRONOUS_OPERATION
이 작업을 비동기적으로 수행합니다.
DS_REPADD_ASYNCHRONOUS_REPLICA
NC를 복제하지 않습니다. 대신 나중에 복제할 수 있도록 충분한 상태 데이터를 저장합니다.
DS_REPADD_DISABLE_NOTIFICATION
이 원본에서 NC에 대한 알림 기반 동기화를 사용하지 않도록 설정합니다. 이는 임시 상태가 될 것으로 예상됩니다. DS_REPADD_NEVER_NOTIFY 사용하여 동기화를 영구적으로 사용하지 않도록 설정합니다.
DS_REPADD_DISABLE_PERIODIC
이 원본에서 NC에 대한 주기적 동기화를 사용하지 않도록 설정합니다.
DS_REPADD_INITIAL
DSA가 시작될 때 이 원본에서 NC를 동기화합니다.
DS_REPADD_INTERSITE_MESSAGING
네이티브 디렉터리 서비스 RPC를 사용하는 대신 IMS(사이트 간 메시징 서비스) 전송(예: SMTP)을 사용하여 원본 DSA에서 동기화합니다.
DS_REPADD_NEVER_NOTIFY
이 원본에서 변경 알림을 사용하지 않도록 설정합니다. 이 플래그가 설정되면 원본은 변경이 발생할 때 대상에 알리지 않습니다. WAN 링크를 통해 발생할 수 있는 모든 사이트 간 복제에 권장됩니다.
이는 영구적인 상태가 될 것으로 예상됩니다. DS_REPADD_DISABLE_NOTIFICATION 사용하여 알림을 일시적으로 사용하지 않도록 설정합니다.
DS_REPADD_PERIODIC
pSchedule에 정의된 대로 이 원본의 NC를 주기적으로 동기화합니다.
DS_REPADD_USE_COMPRESSION
복제할 때 압축을 사용합니다. 이렇게 하면 원본 서버와 대상 서버 모두에서 CPU 오버헤드를 희생하여 네트워크 대역폭을 절약할 수 있습니다.
DS_REPADD_WRITEABLE
쓰기 가능한 복제본(replica) 만듭니다. 그렇지 않으면 복제본(replica) 읽기 전용입니다.
반환 값
함수가 성공하면 반환 값이 ERROR_SUCCESS.
함수가 실패하면 반환 값은 다음 중 하나일 수 있습니다.
설명
참고
ntdsapi.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 DsReplicaAdd를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | ntdsapi.h |
| 라이브러리 | Ntdsapi.lib |
| DLL | Ntdsapi.dll |