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