Функция DsReplicaAddA (ntdsapi.h)
Функция 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 с помощью транспорта Службы обмена мгновенными сообщениями Intersite (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 |
| целевая платформа | Виндоус |
| заголовка | ntdsapi.h |
| библиотеки |
Ntdsapi.lib |
| DLL | Ntdsapi.dll |