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

Статья
03/05/2024

Функция 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. Этот параметр действителен только для NCs, доступных только для чтения без источника.

DS_REPDEL_REF_OK

Позволяет удалять реплика только для чтения, даже если он является источником других реплик, доступных только для чтения.

DS_REPDEL_WRITEABLE

Означает, что удаленный реплика может быть записан в .

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

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

Если функция завершается сбоем, возвращаемое значение представляет собой стандартную ошибку API Win32 или ERROR_INVALID_PARAMETER , если параметр недопустим.

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

Требования

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