DsIsNTDSOnline 函数

[此函数可用于“要求”部分中指定的操作系统。在后续版本中，它可能会被修改，也可能无法使用。从 Windows Vista 开始，请改用卷影复制服务（VSS）。

DsIsNTDSOnline 函数确定Active Directory 域服务是否在指定的服务器上处于联机状态。

语法

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

szServerName [in]: 指向包含要测试的服务器名称的以 null 结尾的字符串的指针。前面的反斜杠是可选的。服务器必须是从中调用此函数的同一台计算机。服务器名称不能包含任何下划线（_）字符。服务器名称的示例为“\\server1”。
pfNTDSOnline [out]: 指向 接收结果的 BOOL 值的指针。 如果目录服务处于联机状态或 FAL，则接收 TRUE标准版如果目录服务处于脱机状态。

如果函数成功或错误代码，则返回S_OK。以下列表列出了可能的错误代码。

ERROR_ACCESS_DENIED: 调用方没有调用此函数的适当访问权限。 DsSetAuthIdentity 函数可用于设置用于备份和还原函数的凭据。
hrCouldNot连接: 找不到 szServerName 中的服务器，不是域控制器，或者 szServerName 格式不正确。此值在 Ntdsbmsg.h 中定义。
RPC_S_INVALID_BINDING: DsIsNTDSOnline 函数正在远程调用，或者 szServerName 中的服务器不是域控制器。

在调用任何目录备份或还原函数之前调用此函数。目录必须处于联机状态才能执行备份。目录必须脱机执行还原。

只能从域控制器调用此函数，该域控制器也是 szServerName 中指定的目标服务器。无法远程调用此函数。

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
标头	Ntdsbcli.h
库	Ntdsbcli.lib
DLL	Ntdsbcli.dll
Unicode 和 ANSI 名称	DsIsNTDSOnlineW （Unicode）和 DsIsNTDSOnlineA （ANSI）