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

Статья
02/29/2024

Функция DsRemoveDsServer удаляет все трассировки агента службы каталогов (DSA) из глобальной области службы каталогов.

Синтаксис

NTDSAPI DWORD DsRemoveDsServerA(
  [in]            HANDLE hDs,
  [in]            LPSTR  ServerDN,
  [in, optional]  LPSTR  DomainDN,
  [out, optional] BOOL   *fLastDcInDomain,
  [in]            BOOL   fCommit
);

Параметры

[in] hDs

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

[in] ServerDN

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

[in, optional] DomainDN

Указатель на строку, завершающуюся нулевым значением, которая указывает домен, размещенный в serverDN. Если этот параметр имеет значение NULL, проверка не выполняется, чтобы убедиться, что serverDN является последним контроллером домена в DomainDN.

[out, optional] fLastDcInDomain

Указатель на логическое значение, которое получает значение TRUE , если serverDN является последним контроллером домена в DomainDN , или FALSE в противном случае. Этот параметр получает значение FALSE , если DomainDN имеет значение NULL.

[in] fCommit

Содержит логическое значение, указывающее, следует ли фактически удалить контроллер домена. Если этот параметр не равен нулю, имя serverDN удаляется. Если этот параметр равен нулю, проверяется существование serverDN и записывается fLastDcInDomain , но контроллер домена не удаляется.

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

Возвращает ERROR_SUCCESS в случае успешного выполнения или код ошибки Win32 или RPC в случае неудачи. Возможные коды ошибок включают следующие.

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

Требования

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

См. также раздел

Контроллер домена и функции управления репликацией

DsBind

DsBindWithCred

DsRemoveDsDomain

Поделиться через