Функция 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
Если задано, указывает, что при завершении входящего репликации целевой сервер должен сообщить исходному серверу синхронизироваться в обратном направлении. Эта функция используется в сценариях с телефонным подключением, где только один из двух серверов может инициировать подключение к телефонному подключению. Например, этот параметр будет использоваться в корпоративной штаб-квартире и филиале, где филиал подключается к корпоративной штаб-квартире через Интернет с помощью подключения isP для телефонного подключения.
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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| минимальный поддерживаемый сервер | Windows Server 2008 |
| целевая платформа | Виндоус |
| заголовка | ntdsapi.h |
| библиотеки |
Ntdsapi.lib |
| DLL | Ntdsapi.dll |