| Previous | Next |
| hrAlreadyOpen | hrCouldNotConnect |
hrInvalidRecips
State represented by this code
hrInvalidRecips means the recipient information supplied to the legacy backup operation failed validation.
The stored value is 0xC7FF0006 (facility-specific HRESULT). The legacy symbolic name comes from the Windows Directory Service backup/restore message header.
The first useful distinction is that this is metadata validation, not a failure to connect to the backup server. Start by preserving the recipient count, structure sizes, encoding, null entries, and the API or component that assembled the recipient list.
Data for a reproducible incident
- Code-specific observation: preserve the recipient count, structure sizes, encoding, null entries, and the API or component that assembled the recipient list.
Objects and state involved
| Diagnostic layer | the legacy Ntdsbcli HBC context and exact API call contract |
|---|---|
| Relevant API surface | DsBackupPrepare/OpenFile/Read/Close/End and DsRestorePrepare/Register/Complete/End |
| Code-specific condition | the recipient information supplied to the legacy backup operation failed validation |
| Narrow corrective direction | rebuild the recipient set from the documented structure and reject malformed entries before calling the API |
Beginning with Windows Vista, Microsoft directs new implementations to VSS instead of these legacy functions. The HBC state advances across calls and must be released even when a later step fails.
Actions that can make diagnosis worse
- Do not reuse an HBC after end, abort, or a fatal sequence error.
- Do not continue after an invalid context or undefined output.
Nearby ESE or AD backup states
It specifically means that this is metadata validation, not a failure to connect to the backup server. Related values below can appear in the same workflow but require a different response:
hrError | the Directory Service backup layer returned an internal failure without a more specific facility code |
|---|---|
hrInvalidHandle | the HBC context or current-file state is invalid for the requested backup/restore operation |
hrNyi | the selected legacy Directory Service backup or restore entry point is present but that operation is not implemented |
Next actions
- Record it,
0xC7FF0006, the API name, the current phase, and all live context or file owners. - Verify the condition by preserving the recipient count, structure sizes, encoding, null entries, and the API or component that assembled the recipient list.
- Apply only the targeted fix: rebuild the recipient set from the documented structure and reject malformed entries before calling the API.
Technical references
- AD backup error values — API ordering, file semantics, warning/error interpretation, or recovery behavior relevant to this HRESULT.
- AD backup walkthrough
- DsRestorePrepare contract
Looking for a different code? Search another status or error code.