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

Статья
03/08/2023

Структура DS_REPL_NEIGHBORW_BLOB содержит данные о состоянии входящего репликации для определенного контекста именования и пары исходного сервера. Эта структура аналогична структуре DS_REPL_NEIGHBOR , но получена из функций API протокола доступа к каталогу при получении двоичных данных для атрибута msDS-NCReplInboundNeighbors .

Синтаксис

typedef struct _DS_REPL_NEIGHBORW_BLOB {
  DWORD    oszNamingContext;
  DWORD    oszSourceDsaDN;
  DWORD    oszSourceDsaAddress;
  DWORD    oszAsyncIntersiteTransportDN;
  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_BLOB;

Члены

oszNamingContext

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

oszSourceDsaDN

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

oszSourceDsaAddress

Содержит смещение (в байтах) от адреса этой структуры до строки Юникода, завершаемой null, которая содержит сетевой адрес исходного сервера, зависящий от транспорта. То есть имя службы имени каталога для репликации RPC/IP или SMTP-адрес для репликации SMTP.

oszAsyncIntersiteTransportDN

Содержит смещение (в байтах) от адреса этой структуры до строки Юникода, завершаемой null, которая содержит различающееся имя объекта interSiteTransport , соответствующее транспорту, по которому выполняется репликация. Этот элемент содержит значение NULL для репликации RPC/IP.

dwReplicaFlags

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

DS_REPL_NBR_WRITEABLE

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

DS_REPL_NBR_SYNC_ON_STARTUP

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

DS_REPL_NBR_DO_SCHEDULED_SYNCS

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

DS_REPL_NBR_USE_ASYNC_INTERSITE_TRANSPORT

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

DS_REPL_NBR_TWO_WAY_SYNC

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

DS_REPL_NBR_FULL_SYNC_IN_PROGRESS

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

DS_REPL_NBR_FULL_SYNC_NEXT_PACKET

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

DS_REPL_NBR_NEVER_SYNCED

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

DS_REPL_NBR_COMPRESS_CHANGES

Изменения, полученные от этого источника, должны быть сжаты. Обычно этот параметр устанавливается только в том случае, если исходный сервер находится на другом сайте.

DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS

От данного источника не следует получать уведомления об изменениях. Обычно устанавливается значение , если исходный сервер находится на другом сайте и только в том случае, если он находится на другом сайте.

dwReserved

Зарезервировано для последующего использования.

uuidNamingContextObjGuid

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

uuidSourceDsaObjGuid

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

uuidSourceDsaInvocationID

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

uuidAsyncIntersiteTransportObjGuid

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

usnLastObjChangeSynced

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

usnAttributeFilter

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

ftimeLastSyncSuccess

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

ftimeLastSyncAttempt

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

dwLastSyncResult

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

cNumConsecutiveSyncFailures

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

Требования

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

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

DS_REPL_NEIGHBOR

FILETIME

API протокола доступа к каталогу упрощенного доступа к каталогу

Поделиться через