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

Статья
03/13/2024

Функция 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