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

Статья
11/20/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

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

[out, optional] fLastDcInDomain

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

[in] fCommit

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

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

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

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
минимальный поддерживаемый сервер	Windows Server 2008
целевая платформа	Виндоус
заголовка	ntdsapi.h
библиотеки	Ntdsapi.lib
DLL	Ntdsapi.dll

См. также

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

DsBind

DsBindWithCred

DsRemoveDsDomain

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