| Previous | Next |
| DB_E_DATAOVERFLOW | DB_E_BADLOOKUPID |
DB_E_BADHRESULT
HRESULT is invalid
Exact value and result class
DB_E_BADHRESULT has unsigned value 2147749464 (0x80040E58) and signed 32-bit value -2147217832. AllStat describes it as “HRESULT is invalid”. In this result, provider-side OLE DB error metadata contains an HRESULT that the error-object machinery considers invalid; the public contract does not identify a consumer data method.
The high bit is set, so DB_E_BADHRESULT is a failure HRESULT. Its facility is 4 (FACILITY_ITF) and its low code is 3672 (0x0E58). For DB_E_BADHRESULT, these fields identify an interface-defined result family; they do not identify the provider instance, method, object generation or partial effects.
Contract boundary
For DB_E_BADHRESULT, OLE DB error objects can contain multiple records. For DB_E_BADHRESULT, provider-side error construction combines an HRESULT, lookup ID, optional parameters, custom error object and dynamic-error lifetime; each identifier has a different namespace and validation rule.
Investigation of DB_E_BADHRESULT should start with the provider code building or resolving the OLE DB error record and the exact IErrorRecords operation. Capture DB_E_BADHRESULT before ADO, ATL, .NET or a database abstraction layer replaces the native HRESULT with a generic exception.
Diagnostic sequence
- Capture raw
0x80040E58and symbolicDB_E_BADHRESULTat the native call boundary. - Identify the exact failing stage for
DB_E_BADHRESULT: provider-side OLE DB error metadata contains an HRESULT that the error-object machinery considers invalid; the public contract does not identify a consumer data method. - Retrieve all OLE DB error records for
DB_E_BADHRESULTbefore another COM call replaces thread error information. - Compare the live object state and provider-granted capabilities with the input that produced
DB_E_BADHRESULT. - Reduce the
DB_E_BADHRESULToperation to the smallest case that preserves the same error contract. - Apply one evidence-backed correction for
DB_E_BADHRESULTand verify that the result is not merely replaced by a neighboring HRESULT.
Conditions that specifically lead to this result
- Cause 1 for
DB_E_BADHRESULT: an error record is built with a nonconforming return value. - Cause 2 for
DB_E_BADHRESULT: memory corruption alters ERRORINFO.hrError. - Cause 3 for
DB_E_BADHRESULT: a provider mixes a native status code with an HRESULT field without conversion.
Evidence to collect
A useful DB_E_BADHRESULT event records provider CLSID and version, process architecture, interface IID and method, object correlation ID, transaction state and the immediately preceding HRESULT. When recording DB_E_BADHRESULT data involving native database messages, error parameters and command fragments, use types, lengths, hashes or redacted identifiers rather than secrets or complete business data.
- Evidence 1 for
DB_E_BADHRESULT: the raw ERRORINFO structure before insertion. - Evidence 2 for
DB_E_BADHRESULT: the provider code path constructing the error record. - Evidence 3 for
DB_E_BADHRESULT: the original native status and conversion function.
Corrective actions
- Action 1 for
DB_E_BADHRESULT: store a valid HRESULT in ERRORINFO.hrError. - Action 2 for
DB_E_BADHRESULT: validate provider-generated error records in tests. - Action 3 for
DB_E_BADHRESULT: keep native status in provider-specific fields rather than overloading HRESULT.
Retry and recovery
Retry rule for DB_E_BADHRESULT: retry only after correcting provider error-record construction; repeating the data operation is not a remedy. A DB_E_BADHRESULT retry is safe only when the relevant input, object generation, capability or external state has changed. Before replaying a modifying call that returned DB_E_BADHRESULT, determine whether rows, schema objects or URL resources were partially created or changed.
Do not turn DB_E_BADHRESULT into an unbounded retry loop. Preserve cancellation for DB_E_BADHRESULT and use a fresh provider object when the failed call may have left local state ambiguous.
Difference from nearby HRESULT values
DB_E_BADLOOKUPID concerns the message lookup key, while DB_E_BADHRESULT concerns the return-code field itself. Telemetry and remediation for DB_E_BADHRESULT should keep these outcomes distinct.
Practical scenario
A custom provider writes a database integer code directly into hrError; mapping it to a documented HRESULT restores error lookup. Keeping DB_E_BADHRESULT with the method and object state makes this scenario diagnosable instead of reducing it to “database error”.
Developer and operations guidance
Code handling DB_E_BADHRESULT should release COM objects in ownership order, retain per-row, per-column or per-property statuses, and log granted capabilities rather than only requested options. While handling DB_E_BADHRESULT, opaque values such as HACCESSOR, HROW, HCHAPTER, DBID components and provider handles must remain scoped to the object that issued them.
Operational dashboards for DB_E_BADHRESULT should group by provider version, interface, method and normalized failure stage. A DB_E_BADHRESULT event must not expose passwords, tokens, full connection strings, unrestricted command text or raw row contents.
Official Microsoft references
- Microsoft: IErrorRecords — official documentation relevant to
DB_E_BADHRESULT. - Microsoft: IErrorRecords::AddErrorRecord — official documentation relevant to
DB_E_BADHRESULT. - Microsoft: OLE DB error lookup services — official documentation relevant to
DB_E_BADHRESULT.
Looking for a different code? Search another status or error code.