Функция DsIsNTDSOnline
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Начиная с 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 |
| Заголовок |
|
| Библиотека |
|
| DLL |
|
| Имя в кодировке Юникод и ANSI |
DsIsNTDSOnlineW (Юникод) и DsIsNTDSOnlineA (ANSI) |