Функция DsReplicaModifyA (ntdsapi.h)
Функция DsReplicaModify изменяет существующую ссылку на источник репликации для контекста именования назначения.
Синтаксис
NTDSAPI DWORD DsReplicaModifyA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] const UUID *pUuidSourceDsa,
[in] LPCSTR TransportDn,
[in] LPCSTR SourceDsaAddress,
[in] const PSCHEDULE pSchedule,
[in] DWORD ReplicaFlags,
[in] DWORD ModifyFields,
[in] DWORD Options
);
Параметры
[in] hDS
Содержит дескриптор службы каталогов, полученный из функции DSBind или DSBindWithCred .
[in] NameContext
Указатель на константную строку, завершающуюся null, которая указывает различающееся имя (DN) контекста именования назначения (NC).
[in] pUuidSourceDsa
Указатель на UUID исходного агента системы каталогов (DSA). Этот параметр может иметь значение NULL, если ModifyFields не содержит DS_REPMOD_UPDATE_ADDRESS и SourceDsaAddress не имеет значения NULL.
[in] TransportDn
Зарезервировано для последующего использования. Любое значение, отличное от NULL , приводит к возврату ERROR_NOT_SUPPORTED .
[in] SourceDsaAddress
Указатель на константную строку Юникода, завершающуюся null, которая указывает адрес исходного DSA, относящееся к транспорту. Этот параметр игнорируется, если pUuidSourceDsa не имеет значение NULL и ModifyFields не включает DS_REPMOD_UPDATE_ADDRESS.
[in] pSchedule
Указатель на структуру SCHEDULE , содержащую данные расписания репликации для источника репликации. Этот параметр является необязательным и может иметь значение NULL , если он не используется. Этот параметр является обязательным, если ModifyFields содержит флаг DS_REPMOD_UPDATE_SCHEDULE .
[in] ReplicaFlags
Этот параметр используется для управления поведением репликации и может принимать следующие значения.
DS_REPL_NBR_SYNC_ON_STARTUP
Репликация контекста именования из этого источника выполняется при загрузке целевого сервера. Это обычно применяется только к внутрисайтовым соседям.
DS_REPL_NBR_DO_SCHEDULED_SYNCS
Выполнение репликации по расписанию. Этот флаг обычно устанавливается, если для этого контекста именования и источника не задано "никогда", то есть пустое расписание.
DS_REPL_NBR_TWO_WAY_SYNC
Если задано значение , указывает, что после завершения входящей репликации целевой сервер должен сообщить исходному серверу о необходимости синхронизации в обратном направлении. Данная функция используется в скриптах коммутируемого доступа, когда коммутируемое подключение может инициировать только один из двух серверов. Например, этот параметр будет использоваться в штаб-квартире и филиале корпорации, если филиал соединяется со штаб-квартирой через Интернет с помощью коммутируемого подключения, предоставляемого поставщиком услуг Интернета.
DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS
Этот сосед настроен для отключения синхронизации на основе уведомлений. В пределах узла контроллеры домена синхронизируются друг с другом на основе уведомлений, когда происходят изменения. Этот параметр не позволяет этому соседу выполнять синхронизацию, активированную уведомлением. Сосед по-прежнему будет выполнять синхронизацию по расписанию или в ответ на запрос синхронизации вручную.
DS_REPL_NBR_DISABLE_SCHEDULED_SYNC
Этот сосед не будет выполнять синхронизацию по расписанию. Синхронизация будет выполняться только в ответ на уведомления об изменениях или на запрос синхронизации вручную.
DS_REPL_NBR_COMPRESS_CHANGES
Изменения, полученные от этого источника, должны быть сжаты. Обычно этот параметр устанавливается только в том случае, если исходный сервер находится на другом сайте.
DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS
От данного источника не следует получать уведомления об изменениях. Обычно этот параметр устанавливается только в том случае, если исходный сервер находится на другом сайте.
[in] ModifyFields
Указывает, какие поля следует изменить. В Поле ModifyFields должно быть указано хотя бы одно поле. Этот параметр может быть сочетанием следующих значений.
DS_REPMOD_UPDATE_ADDRESS
Обновления адрес, связанный с указанным сервером.
DS_REPMOD_UPDATE_FLAGS
Обновления флаги, связанные с реплика.
DS_REPMOD_UPDATE_RESULT
Не используется. Указание обновлений результирующих значений в настоящее время не поддерживается. Значения результатов по умолчанию — 0.
DS_REPMOD_UPDATE_SCHEDULE
Обновления расписание периодической репликации, связанное с реплика.
DS_REPMOD_UPDATE_TRANSPORT
Обновления транспорт, связанный с реплика.
[in] Options
Передает дополнительные данные, используемые для обработки запроса. Этот параметр может быть сочетанием следующих значений.
DS_REPMOD_ASYNCHRONOUS_OPERATION
Выполняет эту операцию асинхронно.
DS_REPMOD_WRITEABLE
Указывает, что реплика может быть записан.
Возвращаемое значение
Если функция завершается успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается сбоем, возвращаемое значение может быть одним из следующих.
Комментарии
Примечание
Заголовок ntdsapi.h определяет DsReplicaModify в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista |
Минимальная версия сервера | Windows Server 2008 |
Целевая платформа | Windows |
Header | ntdsapi.h |
Библиотека | Ntdsapi.lib |
DLL | Ntdsapi.dll |