Site icon EfmSoft

What does HRESULT 0xC80001F9 (hrBackupInProgress) mean?

 
Previous Next
hrBackupDirectoryNotEmpty hrMissingPreviousLogFile

hrBackupInProgress

Operational meaning

hrBackupInProgress means an external backup session is already active for the relevant ESE instance.

The stored value is 0xC80001F9 (negative JET error -505; -505). Current ESE documentation uses JET_errBackupInProgress for the corresponding published JET condition.

The first useful distinction is that this is ESE instance backup exclusivity; hrRestoreInProgress indicates the competing workflow is restore. Start by identifying the owner, start time, current open file, phase, and whether stop/end cleanup has been requested.

Before altering files or retrying

  • Code-specific observation: identify the owner, start time, current open file, phase, and whether stop/end cleanup has been requested.

Comparison points

It specifically means that this is ESE instance backup exclusivity; hrRestoreInProgress indicates the competing workflow is restore. Related values below can appear in the same workflow but require a different response:

hrNoBackupDirectorythe external-backup operation has no destination directory configured for its temporary or copied artifacts
hrInvalidBackupSequencebackup APIs were called in an order that violates the ESE external-backup state machine
hrNoBackupa backup-only API was called when no external backup session is active

Objects and state involved

Diagnostic layerthe ESE external-backup state machine and its single active session
Relevant API surfaceJetBeginExternalBackup, JetGetAttachInfo, JetOpenFile/ReadFile/CloseFile, JetGetLogInfo, and JetEndExternalBackup
Code-specific conditionan external backup session is already active for the relevant ESE instance
Narrow corrective directionfinish or abort the active backup through its documented end path before starting another

Database files are enumerated and copied before the backup advances to the log-file phase. The engine tracks outstanding backup file handles and rejects calls made in the wrong phase.

Recommended handling

  1. Record it, 0xC80001F9, the API name, the current phase, and all live context or file owners.
  2. Verify the condition by identifying the owner, start time, current open file, phase, and whether stop/end cleanup has been requested.
  3. Apply only the targeted fix: finish or abort the active backup through its documented end path before starting another.

Actions that can make diagnosis worse

  • Do not omit the final end/abort path.
  • Do not continue using a context after a sequence failure.

Technical references


Looking for a different code? Search another status or error code.

Exit mobile version