| Previous | Next |
| DB_E_INVALIDTRANSITION | DB_E_MULTIPLESTATEMENTS |
DB_E_NOTASUBREGION
Meaning
Windows documents DB_E_NOTASUBREGION as “Region is not a proper subregion of the region identified by the watch region handle”. Here, an operation requires one region to be a proper subregion of the watch region, but the supplied rows do not satisfy that containment.
Relevant OLE DB contract
This result must be interpreted against this contract: OLE DB views and find operations derive row ranges from an accessor, comparison operators, current ordering and region state; handles and containment relationships become stale when the view, filter or rowset generation changes.
Start with the active rowset view, its criteria accessor and the region or row sequence supplied by the consumer when investigating this result.
Specific conditions that produce the result
- Cause 1: the candidate extends outside the watch-region boundaries.
- Cause 2: the candidate equals the entire watch region when a proper subset is required.
- Cause 3: sort, filter or row changes altered containment after the candidate was calculated.
Evidence to collect before changing the system
- Evidence 1: the watch-region and candidate boundaries.
- Evidence 2: the current view ordering and filter.
- Evidence 3: row-handle identities used for both regions.
Corrective actions
- Action 1: recalculate containment against the current view.
- Action 2: use the correct operation for equal or overlapping regions.
- Action 3: refresh the region after topology or ordering changes.
Retry and recovery policy
Retry rule: retry after supplying a true proper subregion of the current watch region.
Practical incident
A notification consumer passes the whole watch region to an API that requires a smaller affected range; narrowing the candidate prevents it.
Difference from related HRESULT values
DB_E_NONCONTIGUOUSRANGE concerns gaps or non-overlap, while DB_E_NOTASUBREGION concerns failure of the required containment relationship.
Official Microsoft references
Looking for a different code? Search another status or error code.