Функция DsIsNTDSOnline

Статья
06/13/2023

[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Начиная с Windows Vista, используйте службу теневого копирования томов (VSS ).]

Функция DsIsNTDSOnline определяет, подключены ли доменные службы Active Directory на указанном сервере.

Синтаксис

HRESULT DsIsNTDSOnline(
  _In_  LPCTSTR szServerName,
  _Out_ BOOL    *pfNTDSOnline
);

Параметры

szServerName [in]: Указатель на строку, завершающуюся значением NULL, которая содержит имя проверяемого сервера. Предыдущие обратные косые очки являются необязательными. Сервер должен быть тем же компьютером, с которым вызывается эта функция. Имя сервера не может содержать символы подчеркивания (_). Пример имени сервера — "\\server1".
pfNTDSOnline [out]: Указатель на значение BOOL , которое получает результат. Получает значение TRUE , если служба каталогов подключена к сети, или false , если служба каталогов находится в автономном режиме.

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

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

ERROR_ACCESS_DENIED: Вызывающий объект не имеет соответствующих прав доступа для вызова этой функции. С помощью функции DsSetAuthIdentity можно задать учетные данные для функций резервного копирования и восстановления.
hrCouldNotConnect: Не удается найти сервер в szServerName , не является контроллером домена или szServerName неправильно отформатирован. Это значение определено в ntdsbmsg.h.
RPC_S_INVALID_BINDING: Функция DsIsNTDSOnline вызывается удаленно или сервер в szServerName не является контроллером домена.

Вызовите эту функцию перед вызовом любой из функций резервного копирования или восстановления каталога. Чтобы выполнить резервное копирование, каталог должен быть подключен к сети. Чтобы выполнить восстановление, каталог должен находиться в автономном режиме.

Эту функцию можно вызывать только из контроллера домена, который также является целевым сервером, указанным в параметре szServerName. Эту функцию нельзя вызвать удаленно.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Заголовок	Ntdsbcli.h
Библиотека	Ntdsbcli.lib
DLL	Ntdsbcli.dll
Имя в кодировке Юникод и ANSI	DsIsNTDSOnlineW (Юникод) и DsIsNTDSOnlineA (ANSI)

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

DsSetAuthIdentity
Функции резервного копирования каталогов
Резервное копирование и восстановление сервера Active Directory

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