DsSetCurrentBackupLog 函数

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

DsSetCurrentBackupLog 函数在成功还原后设置当前备份日志编号。 由于Active Directory 域服务仅支持循环日志记录,因此通常不使用此函数。

语法

HRESULT DsSetCurrentBackupLog(
  _In_ LPCWSTR szServerName,
  _In_ DWORD   dwCurrentLog
);

参数

szServerName [in]

指向包含要为其设置备份日志编号的服务器名称的以 null 结尾的字符串的指针。 前面的反斜杠是可选的。 服务器必须是从中调用此函数的同一台计算机。 服务器名称不能包含任何下划线 (_) 字符。 服务器名称的示例为“\\server1”。

dwCurrentLog [in]

包含要设置的备份日志编号。

返回值

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

ERROR_INVALID_PARAMETER

一个或多个参数无效。

ERROR_NOT_ENOUGH_MEMORY

发生内存分配失败。

注解

通常不需要调用 DsSetCurrentBackupLog 函数。 备份函数会自动确定并设置备份的最后一个日志编号。 使用 DsSetCurrentBackupLog 防止另一个增量备份成功,直到执行完整备份。

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
标头
Ntdsbcli.h

Ntdsbcli.lib
DLL
Ntdsbcli.dll
Unicode 和 ANSI 名称
DsSetCurrentBackupLogW (Unicode) 和 DsSetCurrentBackupLogA (ANSI)

另请参阅

备份和还原 Active Directory 服务器

目录备份函数