DsBackupTruncateLogs 函数

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

DsBackupTruncateLogs 函数截断以前读取的备份日志。

语法

HRESULT DsBackupTruncateLogs(
  _In_ HBC hbc
);

参数

hbc [in]

包含使用 DsBackupPrepare 函数获取的备份上下文句柄。

返回值

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

ERROR_ACCESS_DENIED

调用方没有调用此函数的适当访问权限。 DsSetAuthIdentity 函数可用于设置用于备份和还原函数的凭据。

ERROR_INVALID_PARAMETER

hbc 无效。

注解

当完整备份或增量备份成功完成时, 请使用 DsBackupTruncateLogs 函数。

注意

如果在差异备份后调用此函数,则所有增量备份信息都将丢失。

要求

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

Ntdsbcli.lib
DLL
Ntdsbcli.dll

另请参阅

DsBackupPrepare

DsBackupGetBackupLogs

DsSetCurrentBackupLog

备份 Active Directory 服务器

目录备份函数