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

Статья
08/25/2023

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

Синтаксис

NTDSAPI DWORD DsReplicaAddA(
  [in] HANDLE          hDS,
  [in] LPCSTR          NameContext,
  [in] LPCSTR          SourceDsaDn,
  [in] LPCSTR          TransportDn,
  [in] LPCSTR          SourceDsaAddress,
  [in] const PSCHEDULE pSchedule,
  [in] DWORD           Options
);

Параметры

[in] hDS

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

[in] NameContext

Строка, заканчивающаяся null, указывающая различающееся имя (DN) контекста именования назначения (NC), для которого добавляется реплика. Целевая запись NC должна существовать локально как объект, созданный экземпляр или нет, или фантом ссылки, например фантом с GUID.

[in] SourceDsaDn

Строка, завершающаяся значением NULL, указывающая DN объекта NTDS-DSA для агента системы исходного каталога. Этот параметр является обязательным, если параметры включают DS_REPADD_ASYNCHRONOUS_REPLICA; в противном случае он игнорируется.

[in] TransportDn

Строка, оканчиваемая null, указывающая DN объекта interSiteTransport , представляющего транспорт, используемый для связи с исходным сервером. Этот параметр является обязательным, если параметры включают DS_REPADD_INTERSITE_MESSAGING; в противном случае он игнорируется.

[in] SourceDsaAddress

Строка, завершающаяся null, указывающая адрес исходного DSA, относящееся к конкретному транспорту. Этот исходный сервер идентифицируется строковым именем, а не его UUID. Строковое имя, подходящее для SourceDsaAddress , обычно является DNS-именем на основе GUID, где часть GUID имени — это GUID объекта NTDS-DSA для исходного сервера.

[in] pSchedule

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

[in] Options

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

DS_REPADD_ASYNCHRONOUS_OPERATION

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

DS_REPADD_ASYNCHRONOUS_REPLICA

Не реплицирует NC. Вместо этого сохраните достаточно данных о состоянии, чтобы их можно было реплицировать позже.

DS_REPADD_DISABLE_NOTIFICATION

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

DS_REPADD_DISABLE_PERIODIC

Отключает периодическую синхронизацию для NC из этого источника.

DS_REPADD_INITIAL

Синхронизирует NC из этого источника при запуске DSA.

DS_REPADD_INTERSITE_MESSAGING

Синхронизируется из исходной DSA с помощью транспорта межсайтовой службы обмена сообщениями (IMS), например по протоколу SMTP, а не с помощью RPC собственной службы каталогов.

DS_REPADD_NEVER_NOTIFY

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

Ожидается, что это постоянное состояние; используйте DS_REPADD_DISABLE_NOTIFICATION для временного отключения уведомлений.

DS_REPADD_PERIODIC

Периодически синхронизирует NC из этого источника, как определено в pSchedule.

DS_REPADD_USE_COMPRESSION

Использует сжатие при репликации. Это позволяет сэкономить пропускную способность сети за счет накладных расходов на ЦП на исходном и целевом серверах.

DS_REPADD_WRITEABLE

Создает записываемую реплика; в противном случае реплика доступно только для чтения.

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

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

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

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

Требования

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