| Previous | Next |
| DB_E_BADPROPERTYVALUE | DB_E_BADACCESSORFLAGS |
DB_E_INVALID
Meaning
Windows documents DB_E_INVALID as “Rowset is not chaptered”. Here, an operation requiring a chaptered rowset is invoked on a rowset that is not chaptered.
Evidence to collect before changing the system
When it involves parent keys, chapter identifiers, row contents and hierarchical paths, record types, lengths, hashes or redacted identifiers instead of secrets or full business data.
- Evidence 1: the rowset interfaces and granted properties.
- Evidence 2: column metadata for chapter columns.
- Evidence 3: the command and result shape that produced the rowset.
Relevant OLE DB contract
This result must be interpreted against this contract: chaptered rowsets expose hierarchical results through chapter columns and HCHAPTER values; a flat rowset, an invalid chapter handle and a valid chapter with no matching row are different contracts and must be diagnosed separately.
Start with the chaptered rowset, parent row and HCHAPTER lifetime associated with the operation when investigating this result.
Specific conditions that produce it
- Cause 1: the rowset was created without chapter support.
- Cause 2: the consumer assumes a hierarchical provider always returns chapters.
- Cause 3: a different result shape is returned for this command execution.
Corrective actions
- Action 1: test for chapter support before chapter operations.
- Action 2: use ordinary row navigation for flat results.
- Action 3: request the provider property or query shape that actually produces chapters.
Practical incident
A data-shaping consumer receives a flat fallback rowset and immediately requests a child chapter; checking the actual rowset shape prevents it.
Retry and recovery policy
Retry rule: retry only with a chaptered rowset or a nonchapter operation.
Difference from related HRESULT values
DB_E_BADCHAPTER means an HCHAPTER is invalid, while DB_E_INVALID here means the rowset itself is not chaptered.
Official Microsoft references
Looking for a different code? Search another status or error code.