структура DS_REPL_NEIGHBORW (ntdsapi.h)

  • Статья

Структура 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

Указатель на строку, завершающуюся значением NULL, которая содержит различающееся имя объекта interSiteTransport , соответствующее транспорту, по которому выполняется репликация. Этот элемент содержит значение NULL для репликации RPC/IP.

dwReplicaFlags

Содержит набор флагов, определяющих атрибуты и параметры для данных репликации. Это может быть ноль или сочетание одного или нескольких из следующих флагов.

DS_REPL_NBR_WRITEABLE (16 (0x10))

Локальная копия контекста именования доступна для записи.

DS_REPL_NBR_SYNC_ON_STARTUP (32 (0x20))

Репликация этого контекста именования из этого источника выполняется при загрузке конечного сервера. Это обычно применяется только к внутрисайтовым соседям.

DS_REPL_NBR_DO_SCHEDULED_SYNCS (64 (0x40))

Выполнение репликации по расписанию. Этот флаг обычно устанавливается, если для этого контекста или источника именования не задано значение "никогда", то есть пустое расписание.

DS_REPL_NBR_USE_ASYNC_INTERSITE_TRANSPORT (128 (0x80))

Выполнение репликации непрямым путем через службу межсайтовых сообщений. Этот флаг устанавливается только при репликации по протоколу SMTP. Флаг не устанавливается при репликации по межсайтовому протоколу RPC/IP.

DS_REPL_NBR_TWO_WAY_SYNC (512 (0x200))

Если этот параметр задан, означает, что после завершения входящей репликации целевой сервер должен сообщить исходному серверу о необходимости синхронизации в обратном направлении. Данная функция используется в скриптах коммутируемого доступа, когда коммутируемое подключение может инициировать только один из двух серверов. Например, этот параметр будет использоваться в штаб-квартире и филиале корпорации, если филиал соединяется со штаб-квартирой через Интернет с помощью коммутируемого подключения, предоставляемого поставщиком услуг Интернета.

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

Содержит objectGuid контекста именования, соответствующего pszNamingContext.

uuidSourceDsaObjGuid

Содержит objectGuid объекта nTDSDSA , соответствующего pszSourceDsaDN.

uuidSourceDsaInvocationID

Содержит идентификатор вызова, используемый исходным сервером при последней попытке репликации.

uuidAsyncIntersiteTransportObjGuid

Содержит objectGuid объекта межсайтового транспорта, соответствующего pszAsyncIntersiteTransportDN.

usnLastObjChangeSynced

Содержит порядковый номер последнего полученного обновления объекта.

usnAttributeFilter

Содержит значение usnLastObjChangeSynced в конце последнего успешного цикла репликации или 0, если нет. Атрибуты в источнике, который в последний раз обновлялся по порядковой номеру обновления, меньшему или равным этому значению, уже были получены и применены назначением.

ftimeLastSyncSuccess

Содержит структуру FILETIME , содержащую дату и время завершения последнего успешного цикла репликации из этого источника. Все члены этой структуры равны нулю, если цикл репликации никогда не был завершен.

ftimeLastSyncAttempt

Содержит структуру FILETIME , содержащую дату и время последней попытки репликации из этого источника. Все члены этой структуры равны нулю, если репликация никогда не предпринималась.

dwLastSyncResult

Содержит код ошибки, связанный с последней попыткой репликации из этого источника. Содержит ERROR_SUCCESS , если последняя попытка была успешно выполнена.

cNumConsecutiveSyncFailures

Содержит количество неудачных попыток репликации из этого источника с момента последней успешной попытки репликации или с момента добавления источника в качестве соседа, если предыдущая попытка не была успешной.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Верхняя часть ntdsapi.h

См. также раздел

DS_REPL_NEIGHBORS

DsReplicaGetInfo

DsReplicaGetInfo2

FILETIME