Функция DsRemoveDsServerA (ntdsapi.h)
Функция 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 |