DsReplicaModifyA 함수(ntdsapi.h)

아티클
11/20/2024

DsReplicaModify 함수는 대상 명명 컨텍스트에 대한 기존 복제 원본 참조를 수정합니다.

통사론

NTDSAPI DWORD DsReplicaModifyA(
  [in] HANDLE          hDS,
  [in] LPCSTR          NameContext,
  [in] const UUID      *pUuidSourceDsa,
  [in] LPCSTR          TransportDn,
  [in] LPCSTR          SourceDsaAddress,
  [in] const PSCHEDULE pSchedule,
  [in] DWORD           ReplicaFlags,
  [in] DWORD           ModifyFields,
  [in] DWORD           Options
);

매개 변수

[in] hDS

DSBind 또는 DSBindWithCred 함수에서 가져온 디렉터리 서비스 핸들을 포함합니다.

[in] NameContext

대상 이름 지정 컨텍스트(NC)의 DN(고유 이름)을 지정하는 상수 null로 끝나는 문자열에 대한 포인터입니다.

[in] pUuidSourceDsa

원본 DSA(디렉터리 시스템 에이전트)의 UUID에 대한 포인터입니다. ModifyFields DS_REPMOD_UPDATE_ADDRESS 포함하지 않고 SourceDsaAddress NULL않으면 이 매개 변수가 null일 수 있습니다.

[in] TransportDn

나중에 사용할 수 있습니다. NULL 이외의 값은 ERROR_NOT_SUPPORTED 반환됩니다.

[in] SourceDsaAddress

원본 DSA의 전송 관련 주소를 지정하는 null로 끝나는 상수 유니코드 문자열에 대한 포인터입니다. 이 매개 변수는 pUuidSourceDsa NULL 않고 ModifyFields DS_REPMOD_UPDATE_ADDRESS포함하지 않는 경우 무시됩니다.

[in] pSchedule

복제 원본에 대한 복제 일정 데이터를 포함하는 SCHEDULE 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며, 사용하지 않을 경우 NULL 수 있습니다. 이 매개 변수는 ModifyFieldsDS_REPMOD_UPDATE_SCHEDULE 플래그를 포함하는 경우에 필요합니다.

[in] ReplicaFlags

이 매개 변수는 복제 동작을 제어하는 데 사용되며 다음 값을 사용할 수 있습니다.

DS_REPL_NBR_SYNC_ON_STARTUP

이 원본에서 이 명명 컨텍스트의 복제는 대상 서버가 부팅될 때 시도됩니다. 이는 일반적으로 사이트 내 인접에만 적용됩니다.

DS_REPL_NBR_DO_SCHEDULED_SYNCS

일정에 따라 복제를 수행합니다. 이 명명 컨텍스트 및 원본에 대한 일정이 빈 일정인 "never"가 아닌 한 이 플래그는 일반적으로 설정됩니다.

DS_REPL_NBR_TWO_WAY_SYNC

설정된 경우 인바운드 복제가 완료되면 대상 서버가 원본 서버에 역방향으로 동기화하도록 지시해야 임을 나타냅니다. 이 기능은 두 서버 중 하나만 전화 접속 연결을 시작할 수 있는 전화 접속 시나리오에서 사용됩니다. 예를 들어 이 옵션은 지점이 전화 접속 ISP 연결을 통해 인터넷을 통해 본사에 연결하는 본사 및 지점에서 사용됩니다.

DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS

이 인접 항목은 알림 기반 동기화를 사용하지 않도록 설정됩니다. 사이트 내에서 도메인 컨트롤러는 변경이 발생할 때 알림에 따라 서로 동기화됩니다. 이 설정을 사용하면 이 인접 항목이 알림에 의해 트리거되는 동기화를 수행할 수 없습니다. 인접 항목은 일정에 따라 또는 수동으로 요청된 동기화에 대한 응답으로 동기화를 계속 수행합니다.

DS_REPL_NBR_DISABLE_SCHEDULED_SYNC

이 인접 항목은 일정에 따라 동기화를 수행하지 않도록 설정됩니다. 이 인접 항목이 동기화를 수행하는 유일한 방법은 변경 알림 또는 수동으로 요청된 동기화에 대한 응답입니다.

DS_REPL_NBR_COMPRESS_CHANGES

이 원본에서 받은 변경 내용은 압축되어야 합니다. 원본 서버가 다른 사이트에 있는 경우에만 일반적으로 설정됩니다.

DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS

이 원본에서 변경 알림을 수신하지 않아야 합니다. 원본 서버가 다른 사이트에 있는 경우에만 일반적으로 설정됩니다.

[in] ModifyFields

수정할 필드를 지정합니다. ModifyFields하나 이상의 필드를 지정해야 합니다. 이 매개 변수는 다음 값의 조합일 수 있습니다.

DS_REPMOD_UPDATE_ADDRESS

참조된 서버와 연결된 주소를 업데이트합니다.

DS_REPMOD_UPDATE_FLAGS

복제본과 연결된 플래그를 업데이트합니다.

DS_REPMOD_UPDATE_RESULT

사용되지 않습니다. 결과 값의 업데이트 지정은 현재 지원되지 않습니다. 결과 값은 기본적으로 0입니다.

DS_REPMOD_UPDATE_SCHEDULE

복제본과 연결된 정기적인 복제 일정을 업데이트합니다.

DS_REPMOD_UPDATE_TRANSPORT

복제본과 연결된 전송을 업데이트합니다.

[in] Options

요청을 처리하는 데 사용되는 추가 데이터를 전달합니다. 이 매개 변수는 다음 값의 조합일 수 있습니다.

DS_REPMOD_ASYNCHRONOUS_OPERATION

이 작업을 비동기적으로 수행합니다.

DS_REPMOD_WRITEABLE

수정 중인 복제본을 쓸 수 있음을 나타냅니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

함수가 실패하면 반환 값은 다음 중 하나일 수 있습니다.

발언

메모

ntdsapi.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 DsReplicaModify를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

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