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

Статья
08/25/2023

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

Синтаксис

NTDSAPI DWORD DsReplicaSyncAllA(
  [in]            HANDLE                                  hDS,
  [in]            LPCSTR                                  pszNameContext,
  [in]            ULONG                                   ulFlags,
  [in]            BOOL(* )(LPVOID,PDS_REPSYNCALL_UPDATEA) pFnCallBack,
  [in, optional]  LPVOID                                  pCallbackData,
  [out, optional] PDS_REPSYNCALL_ERRINFOA                 **pErrors
);

Параметры

[in] hDS

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

[in] pszNameContext

Указатель на строку, завершающуюся null, которая указывает различающееся имя контекста именования для синхронизации. Параметр pszNameContext является необязательным; Если его значение равно NULL, контекст именования конфигурации реплицируется.

[in] ulFlags

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

DS_REPSYNCALL_ABORT_IF_SERVER_UNAVAILABLE

Создает неустранимую ошибку, если не удается связаться с каким-либо сервером или если какой-либо сервер недоступен из-за отключенной или неисправной топологии.

DS_REPSYNCALL_CROSS_SITE_BOUNDARIES

Выполняет синхронизацию через границы узелов. По умолчанию DsReplicaSyncAll пытается синхронизировать только с контроллерами домена на том же сайте, что и домашняя система. Установите этот флаг, чтобы попытаться синхронизироваться со всеми контроллерами домена в корпоративном лесу. Однако контроллеры домена можно синхронизировать только в том случае, если они соединены синхронным транспортом (RPC).

DS_REPSYNCALL_DO_NOT_SYNC

Полностью отключает синхронизацию. Топология по-прежнему анализируется, и по-прежнему выявляются недоступные или недоступные серверы.

DS_REPSYNCALL_ID_SERVERS_BY_DN

В случае неустранимой ошибки возвращает различающиеся имена сервера (DN) вместо DNS-имен GUID.

DS_REPSYNCALL_NO_OPTIONS

Этот параметр не действует.

DS_REPSYNCALL_PUSH_CHANGES_OUTWARD

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

DS_REPSYNCALL_SKIP_INITIAL_CHECK

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

DS_REPSYNCALL_SYNC_ADJACENT_SERVERS_ONLY

Отключает транзитивную репликацию. Синхронизация выполняется только со смежными серверами.

[in] pFnCallBack

Указатель на определяемую приложением функцию SyncUpdateProc , вызываемую функцией DsReplicaSyncAll , когда она обнаруживает ошибку, инициирует синхронизацию двух серверов, завершает синхронизацию двух серверов или завершает синхронизацию всех серверов на сайте.

[in, optional] pCallbackData

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

[out, optional] pErrors

Массив указателей на , заканчивающийся null
DS_REPSYNCALL_ERRINFO структуры, содержащие ошибки, возникшие во время синхронизации. Память, используемая для хранения массива указателей и MsCS\mscs\clusctl_resource_type_get_private_property_fmts.xml данных, выделяется в виде одного блока памяти и должна быть освобождена, если один вызов LocalFree больше не требуется с возвращаемым значением указателя в pErrors , используемом в качестве аргумента.

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

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

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

Функция DsReplicaSyncAll пытается выполнить привязку ко всем серверам перед созданием топологии для синхронизации. Если с сервером не удается связаться, функция исключает этот сервер из топологии и пытается обойти его. Установка флага DS_REPSYNCALL_SKIP_INITIAL_CHECK в ulFlags обходит начальную привязку.

Если с сервером не удается связаться, функция DsReplicaSyncAll пытается маршрутизировать его и реплицировать с максимально возможного числа серверов, если DS_REPSYNCALL_ABORT_IF_SERVER_UNAVAILABLE не задано в ulFlags.

Функция DsReplicaSyncAll может использовать функцию обратного вызова, на которую указывает pFnCallBack , для информирования конечного пользователя о текущем состоянии репликации. Выполнение функции DsReplicaSyncAll приостанавливается при вызове функции, на которую указывает pFnCallBack. Если значение, возвращаемое функцией обратного вызова, равно TRUE, репликация продолжается; в противном случае функция DsReplicaSyncAll завершает репликацию.

Примечание

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

Требования

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