DsSetCurrentBackupLog

The DsSetCurrentBackupLog function sets the current backup log number after a successful restore.

HRESULT DsSetCurrentBackupLog(
  LPCWSTR szServerName,
  DWORD dwCurrentLog
);

Parameters

szServerName

[in] The name of the server to back up. Preceding backslashes are optional. An example of a server name is \\server1.

Note  The server name cannot contain an underscore.

dwCurrentLog

[in] Current log number.

Return Values

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

Remarks

The DsSetCurrentBackupLog function does not normally need to be called. The backup functions automatically determine and set the last log number backed up. Use DsSetCurrentBackupLog to prevent another incremental backup from succeeding until a full backup is performed.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Ntdsbcli.h.
  Library: Included as a resource in Ntdsbcli.dll.
  Unicode: Implemented as Unicode and ANSI versions on Windows 2000.

See Also

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