Функция DsReplicaSyncA (ntdsapi.h)

Статья
08/25/2023

Функция DsReplicaSync синхронизирует контекст именования назначения (NC) с одним из его источников.

Синтаксис

NTDSAPI DWORD DsReplicaSyncA(
  [in] HANDLE     hDS,
  [in] LPCSTR     NameContext,
  [in] const UUID *pUuidDsaSrc,
  [in] ULONG      Options
);

Параметры

[in] hDS

Содержит дескриптор службы каталогов, полученный из функции DSBind или DSBindWithCred .

[in] NameContext

Указатель на константную строку, завершающуюся значением NULL, которая указывает различающееся имя целевого контроллера NC.

[in] pUuidDsaSrc

Указатель на UUID источника, который реплицируется в целевой сетевой контроллер.

[in] Options

Передает дополнительные данные, используемые для обработки запроса. Этот параметр может быть сочетанием следующих значений.

DS_REPSYNC_ADD_REFERENCE

Заставляет исходный агент системы каталогов (DSA) проверить наличие локального DSA в списке реплицируемых в источник. В противном случае добавляется локальный DSA. Это гарантирует, что источник отправляет уведомления об изменениях.

DS_REPSYNC_ALL_SOURCES

Это значение не поддерживается.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista и Windows Server 2003: Синхронизируется из всех источников.

DS_REPSYNC_ASYNCHRONOUS_OPERATION

Выполняет эту операцию асинхронно.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista и Windows Server 2003: Требуется при использовании DS_REPSYNC_ALL_SOURCES.

DS_REPSYNC_FORCE

Синхронизируется, даже если ссылка в настоящее время отключена.

DS_REPSYNC_FULL

Синхронизирует, начиная с первого номера обновления (USN).

DS_REPSYNC_INTERSITE_MESSAGING

Синхронизирует с помощью ISM.

DS_REPSYNC_NO_DISCARD

Не отменяет этот запрос синхронизации, даже если аналогичная синхронизация ожидается.

DS_REPSYNC_PERIODIC

Указывает, что эта операция является периодическим запросом синхронизации, запланированным администратором.

DS_REPSYNC_URGENT

Указывает, что эта операция является уведомлением об обновлении, помеченном как срочное.

DS_REPSYNC_WRITEABLE

Реплика доступна для записи. В противном случае он будет доступен только для чтения.

Возвращаемое значение

Если функция успешно выполняет свою операцию, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение является одной из стандартных ошибок API Win32.

Сервер, на который выполняется DsReplicaSync , называется назначением. Контекст именования назначения обновлен относительно исходной системы, определяемой UUID объекта параметров NTDS исходной системы. Конечная система уже должна быть настроена таким образом, чтобы исходная система была одной из систем, из которых она получает данные репликации.

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

Примечание

Заголовок ntdsapi.h определяет DsReplicaSync в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	ntdsapi.h
Библиотека	Ntdsapi.lib
DLL	Ntdsapi.dll