Функция DsReplicaDelA (ntdsapi.h)
Функция DsReplicaDel удаляет ссылку на источник репликации из контекста именования назначения (NC).
Синтаксис
NTDSAPI DWORD DsReplicaDelA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] LPCSTR DsaSrc,
[in] ULONG Options
);
Параметры
[in] hDS
Содержит дескриптор службы каталогов, полученный из функции DSBind или DSBindWithCred.
[in] NameContext
Указатель на строку с константой, завершаемой значением NULL, которая указывает различающееся имя (DN) целевого NC, из которого удаляется реплика. Целевая запись NC должна существовать локально как объект, экземпляр или нет, или эталонный фантом, например фантом с GUID.
[in] DsaSrc
Указатель на строку Юникода с константой, завершающей значение NULL, которая указывает адрес, зависящий от транспорта агента системы исходного каталога (DSA). Этот исходный сервер определяется строковым именем, а не его UUID. Строковое имя, подходящее для DsaSrc, обычно является DNS-именем, основанным на GUID, где GUID частью имени является GUID объекта nTDSDSA для исходного сервера.
[in] Options
Передает дополнительные данные, используемые для обработки запроса. Этот параметр может быть сочетанием следующих значений.
DS_REPDEL_ASYNCHRONOUS_OPERATION
Выполняет эту операцию асинхронно.
DS_REPDEL_IGNORE_ERRORS
Игнорирует любую ошибку, созданную при обращении к источнику, чтобы указать ему удалить этот NC из списка серверов, на которые она реплицируется.
DS_REPDEL_INTERSITE_MESSAGING
Указывает, что реплика основана на почте, а не синхронизирована с помощью RPC собственной службы каталогов.
DS_REPDEL_LOCAL_ONLY
Не обращается к источнику, чтобы сообщить ему удалить этот NC из списка серверов, на которые он реплицируется. Если этот флаг не задан, и ссылка основана на RPC, источник обращается.
DS_REPDEL_NO_SOURCE
Удаляет все объекты в NC. Этот параметр действителен только для сетевых компьютеров только для чтения без источника.
DS_REPDEL_REF_OK
Разрешает удаление реплики только для чтения, даже если она источник других реплик только для чтения.
DS_REPDEL_WRITEABLE
Указывает, что удаленная реплика может быть записана в.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение ERROR_SUCCESS.
Если функция завершается ошибкой, возвращаемое значение является стандартной ошибкой API Win32 или ERROR_INVALID_PARAMETER, если параметр недопустим.
Замечания
Заметка
Заголовок ntdsapi.h определяет DsReplicaDel как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| минимальный поддерживаемый сервер | Windows Server 2008 |
| целевая платформа | Виндоус |
| заголовка | ntdsapi.h |
| библиотеки |
Ntdsapi.lib |
| DLL | Ntdsapi.dll |