Directory Services

DsBackupTruncateLogs

The DsBackupTruncateLogs function truncates the backup logs that are already read.

HRESULT DsBackupTruncateLogs(
  HBC hbc
);

Parameters

hbc
[in] Points to the client context handle of the backup.

Return Values

One of the standard HRESULT success codes; otherwise, a failure code.

Remarks

Use the DsBackupTruncateLogs function when a full or incremental backup has completed successfully.

Warning  Do not use this function after a differential backup.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Header: Declared in Ntdsbcli.h.
Library: Use Ntdsbcli.lib.

See Also

Backing Up and Restoring Active Directory, Directory Backup Functions, DsSetCurrentBackupLog