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

Статья
11/20/2024

Функция 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 источника, который реплицируется в целевой NC.

[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, вызывается назначением. Контекст именования назначения добавляется up-to-date относительно исходной системы, определяемой UUID объекта NTDS исходной системы. Целевая система должна быть уже настроена таким образом, чтобы исходная система была одной из систем, из которых она получает данные репликации.

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
минимальный поддерживаемый сервер	Windows Server 2008
целевая платформа	Виндоус
заголовка	ntdsapi.h
библиотеки	Ntdsapi.lib
DLL	Ntdsapi.dll