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

Статья
08/25/2023

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

Синтаксис

NTDSAPI DWORD DsReplicaUpdateRefsA(
  [in] HANDLE     hDS,
  [in] LPCSTR     NameContext,
  [in] LPCSTR     DsaDest,
  [in] const UUID *pUuidDsaDest,
  [in] ULONG      Options
);

Параметры

[in] hDS

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

[in] NameContext

Указатель на константную строку, завершающуюся null, которая указывает различающееся имя контекста именования источника.

[in] DsaDest

Указатель на константную строку, завершающуюся значением NULL, которая указывает адрес конечного системного агента каталогов, относящееся к конкретному транспорту.

[in] pUuidDsaDest

Указатель на значение UUID , содержащее конечный агент системы каталогов.

[in] Options

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

DS_REPUPD_ADD_REFERENCE

Ссылка на назначение добавляется на исходный сервер.

DS_REPUPD_ASYNCHRONOUS_OPERATION

Операция выполняется асинхронно.

DS_REPUPD_DELETE_REFERENCE

Ссылка на назначение удаляется с исходного сервера.

DS_REPUPD_WRITEABLE

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

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

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

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

Если DS_REPUPD_ADD_REFERENCE и DS_REPUPD_DELETE_REFERENCE заданы в параметре Options , ссылка на назначение добавляется, если она еще не существует на сервере. Если ссылка на назначение уже существует, ссылка обновляется.

Примечание

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

Требования

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