Platform SDK: Exchange Server

HrSetCurrentBackupLog

The HrSetCurrentBackupLog function sets the last log number that was backed up.

Quick Info

Header file: EDBBCLI.H
Library: EDBBCLI.LIB
Unicode: Yes

HRESULT HrSetCurrentBackupLog(
  LPTSTR szServerName,        
  LPTSTR szBackupAnnotation,  
  DWORD dwCurrentLog          
);
 

Parameters

szServerName
Input parameter. The name of the server to backup. Preceding backslashes are optional. An example of a server name is \\server1.

Note  The server name cannot contain an underscore.

szBackupAnnotation
Input parameter. The database to set log on. Possible choices are EDBBACK_MDB_DATABASE and EDBBACK_DIRECTORY_DATABASE.
dwCurrentLog
Input parameter. The last log number backed up. Set dwCurrentLog to BACKUP_DISABLE_INCREMENTAL to prevent incremental backups until a full backup is performed (see Preventing an Incremental Backup Until a Full Backup Is Performed).

Return Values

See Return Values.

Remarks

The HrSetCurrentBackupLog function does not normally need to be called. The backup functions automatically determine and set the last log number backed up. Use HrSetCurrentBackupLog to prevent another incremental backup from succeeding until a full backup is performed. For example, after running a defragmentation on the directory or information store in the Microsoft Exchange Server Administrator program, no further incremental backups are allowed until a full backup is performed.

For more information on this function, see Backing Up and Restoring Data.

See Also

HrRestoreRegister