| Previous | Next |
| DB_E_DATAOVERFLOW | DB_E_BADLOOKUPID |
DB_E_BADHRESULT
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 this result is a failure HRESULT. Its facility is 4 (FACILITY_ITF) and its low code is 3672 (0x0E58). These fields identify an interface-defined result family; they do not identify the provider instance, method, object generation or partial effects.
Contract boundary
OLE DB error objects can contain multiple records. 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 this result should start with the provider code building or resolving the OLE DB error record and the exact IErrorRecords operation. Capture it before ADO, ATL,.NET or a database abstraction layer replaces the native HRESULT with a generic exception.
Diagnostic sequence
- Capture raw
0x80040E58and symbolic this result at the native call boundary. - Identify the exact failing stage for it: 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 it before another COM call replaces thread error information.
- Compare the live object state and provider-granted capabilities with the input that produced it.
- Reduce the operation to the smallest case that preserves the same error contract.
- Apply one evidence-backed correction for it and verify that the result is not merely replaced by a neighboring HRESULT.
Conditions that specifically lead to it
- Cause 1 for it: an error record is built with a nonconforming return value.
- Cause 2 for it: memory corruption alters ERRORINFO.hrError.
- Cause 3 for it: a provider mixes a native status code with an HRESULT field without conversion.
Evidence to collect
A useful it event records provider CLSID and version, process architecture, interface IID and method, object correlation ID, transaction state and the immediately preceding HRESULT. When recording it 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 it: the raw ERRORINFO structure before insertion.
- Evidence 2 for it: the provider code path constructing the error record.
- Evidence 3 for it: the original native status and conversion function.
Corrective actions
- Action 1 for it: store a valid HRESULT in ERRORINFO.hrError.
- Action 2 for it: validate provider-generated error records in tests.
- Action 3 for it: keep native status in provider-specific fields rather than overloading HRESULT.
Retry and recovery
Retry rule for it: retry only after correcting provider error-record construction; repeating the data operation is not a remedy. A it retry is safe only when the relevant input, object generation, capability or external state has changed. Before replaying a modifying call that returned it, determine whether rows, schema objects or URL resources were partially created or changed.
Do not turn it into an unbounded retry loop. Preserve cancellation for it 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 it concerns the return-code field itself. Telemetry and remediation for it 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 it with the method and object state makes this scenario diagnosable instead of reducing it to “database error”.
Developer and operations guidance
Code handling it 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 it, opaque values such as HACCESSOR, HROW, HCHAPTER, DBID components and provider handles must remain scoped to the object that issued them.
Operational dashboards for it should group by provider version, interface, method and normalized failure stage. A it event must not expose passwords, tokens, full connection strings, unrestricted command text or raw row contents.
Official Microsoft references
- Microsoft: IErrorRecords
- Microsoft: IErrorRecords::AddErrorRecord
- Microsoft: OLE DB error lookup services
Looking for a different code? Search another status or error code.