DS_REPL_NEIGHBORW 구조체(ntdsapi.h)

아티클
08/25/2023

DS_REPL_NEIGHBOR 구조에는 DsReplicaGetInfo 및 DsReplicaGetInfo2 함수에서 반환한 특정 명명 컨텍스트 및 원본 서버 쌍에 대한 인바운드 복제 상태 데이터가 포함됩니다.

구문

typedef struct _DS_REPL_NEIGHBORW {
  LPWSTR   pszNamingContext;
  LPWSTR   pszSourceDsaDN;
  LPWSTR   pszSourceDsaAddress;
  LPWSTR   pszAsyncIntersiteTransportDN;
  DWORD    dwReplicaFlags;
  DWORD    dwReserved;
  UUID     uuidNamingContextObjGuid;
  UUID     uuidSourceDsaObjGuid;
  UUID     uuidSourceDsaInvocationID;
  UUID     uuidAsyncIntersiteTransportObjGuid;
  USN      usnLastObjChangeSynced;
  USN      usnAttributeFilter;
  FILETIME ftimeLastSyncSuccess;
  FILETIME ftimeLastSyncAttempt;
  DWORD    dwLastSyncResult;
  DWORD    cNumConsecutiveSyncFailures;
} DS_REPL_NEIGHBORW;

멤버

pszNamingContext

이 복제 상태 데이터가 관련된 명명 컨텍스트를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 명명 컨텍스트가 동일한 원본 서버에서 복제되더라도 각 명명 컨텍스트는 독립적으로 복제되고 서로 다른 연결된 인접 데이터를 가집니다.

pszSourceDsaDN

이 복제 상태 데이터가 관련된 원본 서버에 해당하는 디렉터리 서비스 에이전트의 고유 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 각 원본 서버에는 서로 다른 연결된 인접 데이터가 있습니다.

pszSourceDsaAddress

원본 서버의 전송 관련 네트워크 주소를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 즉, RPC/IP 복제의 디렉터리 이름 서비스 이름 또는 SMTP 복제의 SMTP 주소입니다.

pszAsyncIntersiteTransportDN

복제가 수행되는 전송에 해당하는 interSiteTransport 개체의 고유 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 이 멤버에는 RPC/IP 복제에 대한 NULL 이 포함되어 있습니다.

dwReplicaFlags

복제 데이터에 대한 특성 및 옵션을 지정하는 플래그 집합을 포함합니다. 0이거나 다음 플래그 중 하나 이상의 조합일 수 있습니다.

DS_REPL_NBR_WRITEABLE(16(0x10))

명명 컨텍스트의 로컬 복사본에 쓸 수 있습니다.

DS_REPL_NBR_SYNC_ON_STARTUP(32(0x20))

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

DS_REPL_NBR_DO_SCHEDULED_SYNCS(64(0x40))

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

DS_REPL_NBR_USE_ASYNC_INTERSITE_TRANSPORT(128(0x80))

사이트 간 메시징 서비스를 통해 간접적으로 복제를 수행합니다. 이 플래그는 SMTP를 통해 복제하는 경우에만 설정됩니다. 이 플래그는 사이트 간 RPC/IP를 통해 복제하는 경우에는 설정되지 않습니다.

DS_REPL_NBR_TWO_WAY_SYNC (512(0x200))

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

DS_REPL_NBR_RETURN_OBJECT_PARENTS(2048년(0x800))

인접한 복제 대상에서 자식 개체 전에 부모 개체를 반환하하고 있습니다. 부모 개체 전에 자식 개체를 수신하고 나면 이 상태가 됩니다.

DS_REPL_NBR_FULL_SYNC_IN_PROGRESS (65536 (0x10000))

대상 서버가 소스 서버로부터 완전 동기화를 수행합니다. 전체 동기화는 업데이트를 필터링하기 위해 업데이트(DS_REPL_CURSORS)를 만드는 벡터를 사용하지 않습니다. 완전 동기화는 일반 복제 프로토콜의 일부로 사용되지 않습니다.

DS_REPL_NBR_FULL_SYNC_NEXT_PACKET(131072(0x20000))

원본의 마지막 패킷은 대상 서버가 아직 만들지 않은 개체를 수정했음을 나타냅니다. 요청할 다음 패킷은 원본 서버에 수정된 개체의 모든 특성을 패킷에 넣도록 지시합니다.

DS_REPL_NBR_NEVER_SYNCED(2097152(0x200000))

동기화가 이 소스로부터 성공적으로 완료된 적이 없습니다.

DS_REPL_NBR_PREEMPTED(16777216(0x1000000))

이 파티션 또는 다른 파티션에 대해 우선 순위가 높은 다른 이웃을 서비스하기 위해 복제 엔진에서 이 인접 항목 처리를 일시적으로 중지했습니다. 복제 엔진은 우선 순위가 높은 작업이 완료되면 해당하는 복제 인접 대상의 처리를 다시 시작합니다.

DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS(67108864(0x4000000))

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

DS_REPL_NBR_DISABLE_SCHEDULED_SYNC(134217728(0x8000000))

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

DS_REPL_NBR_COMPRESS_CHANGES(268435456(0x10000000))

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

DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS(536870912(0x20000000))

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

DS_REPL_NBR_PARTIAL_ATTRIBUTE_SET(1073741824(0x40000000))

인접한 복제 대상에서 일부 특성 집합의 변경 때문에 이 복제본의 내용을 다시 만들고 있습니다.

dwReserved

다음에 사용하도록 예약됩니다.

uuidNamingContextObjGuid

pszNamingContext에 해당하는 명명 컨텍스트의 objectGuid를 포함합니다.

uuidSourceDsaObjGuid

pszSourceDsaDN에 해당하는 nTDSDSA 개체의 objectGuid를 포함합니다.

uuidSourceDsaInvocationID

마지막 복제 시도에서 원본 서버에서 사용하는 호출 식별자를 포함합니다.

uuidAsyncIntersiteTransportObjGuid

pszAsyncIntersiteTransportDN에 해당하는 사이트 간 전송 개체의 objectGuid를 포함합니다.

usnLastObjChangeSynced

마지막으로 받은 개체 업데이트의 업데이트 시퀀스 번호를 포함합니다.

usnAttributeFilter

마지막 완료, 성공적인 복제 주기의 끝에 있는 usnLastObjChangeSynced 값 또는 없는 경우 0을 포함합니다. 이 값보다 작거나 같은 업데이트 시퀀스 번호로 마지막으로 업데이트된 원본의 특성은 이미 수신되어 대상에 의해 적용되었습니다.

ftimeLastSyncSuccess

이 원본에서 마지막으로 성공한 복제 주기가 완료된 날짜와 시간을 포함하는 FILETIME 구조체를 포함합니다. 복제 주기가 완료되지 않은 경우 이 구조체의 모든 멤버는 0입니다.

ftimeLastSyncAttempt

이 원본의 마지막 복제 시도 날짜와 시간을 포함하는 FILETIME 구조체를 포함합니다. 복제를 시도한 적이 없는 경우 이 구조체의 모든 멤버는 0입니다.

dwLastSyncResult

이 원본의 마지막 복제 시도와 관련된 오류 코드를 포함합니다. 마지막 시도가 성공했는지 ERROR_SUCCESS 포함합니다.

cNumConsecutiveSyncFailures

마지막으로 성공한 복제 시도 이후 또는 이전 시도가 성공하지 못한 경우 원본이 인접 항목으로 추가된 이후 이 원본에서 실패한 복제 시도 횟수를 포함합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
머리글	ntdsapi.h

추가 정보

다음을 통해 공유