| Previous | Next |
| DB_E_READONLY | DB_E_CANNOTCONNECT |
DB_E_ASYNCNOTSUPPORTED
Asynchronous binding is not supported by this provider
Exact value and result class
DB_E_ASYNCNOTSUPPORTED has unsigned value 2147749525 (0x80040E95) and signed 32-bit value -2147217771. AllStat describes it as “Asynchronous binding is not supported by this provider”. In this result, the consumer requests asynchronous URL binding from a provider that supports only synchronous binding.
The high bit is set, so DB_E_ASYNCNOTSUPPORTED is a failure HRESULT. Its facility is 4 (FACILITY_ITF) and its low code is 3733 (0x0E95). For DB_E_ASYNCNOTSUPPORTED, these fields identify an interface-defined result family; they do not identify the provider instance, method, object generation or partial effects.
Conditions that specifically lead to this result
- Cause 1 for
DB_E_ASYNCNOTSUPPORTED: an asynchronous bind flag is set without capability negotiation. - Cause 2 for
DB_E_ASYNCNOTSUPPORTED: the provider implements binding but not IDBAsynchStatus for that object. - Cause 3 for
DB_E_ASYNCNOTSUPPORTED: a generic client assumes all remote URLs support async progress.
Contract boundary
For DB_E_ASYNCNOTSUPPORTED, the OLE DB binder model maps URLs to row, rowset, stream or collection objects. For DB_E_ASYNCNOTSUPPORTED, URL scope, requested object type, bind flags, asynchronous capability, locks and server reachability are independent parts of the binding contract.
Investigation of DB_E_ASYNCNOTSUPPORTED should start with the binder or session, normalized URL, requested GUID/object type and DBBINDURLSTATUS result. Capture DB_E_ASYNCNOTSUPPORTED before ADO, ATL, .NET or a database abstraction layer replaces the native HRESULT with a generic exception.
Diagnostic sequence
- Capture raw
0x80040E95and symbolicDB_E_ASYNCNOTSUPPORTEDat the native call boundary. - Identify the exact failing stage for
DB_E_ASYNCNOTSUPPORTED: the consumer requests asynchronous URL binding from a provider that supports only synchronous binding. - Retrieve all OLE DB error records for
DB_E_ASYNCNOTSUPPORTEDbefore another COM call replaces thread error information. - Compare the live object state and provider-granted capabilities with the input that produced
DB_E_ASYNCNOTSUPPORTED. - Reduce the
DB_E_ASYNCNOTSUPPORTEDoperation to the smallest case that preserves the same binder contract. - Apply one evidence-backed correction for
DB_E_ASYNCNOTSUPPORTEDand verify that the result is not merely replaced by a neighboring HRESULT.
Evidence to collect
A useful DB_E_ASYNCNOTSUPPORTED 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_ASYNCNOTSUPPORTED data involving URLs containing credentials, tenant paths and remote object names, use types, lengths, hashes or redacted identifiers rather than secrets or complete business data.
- Evidence 1 for
DB_E_ASYNCNOTSUPPORTED: bind flags and requested object type. - Evidence 2 for
DB_E_ASYNCNOTSUPPORTED: provider asynchronous capability properties. - Evidence 3 for
DB_E_ASYNCNOTSUPPORTED: interfaces exposed on the returned or binder object.
Corrective actions
- Action 1 for
DB_E_ASYNCNOTSUPPORTED: fall back to synchronous binding on a worker thread when safe. - Action 2 for
DB_E_ASYNCNOTSUPPORTED: feature-detect async support. - Action 3 for
DB_E_ASYNCNOTSUPPORTED: keep cancellation semantics explicit in the fallback.
Practical scenario
A UI requests async binding from a file-backed provider with synchronous-only support; moving the bind to a worker preserves responsiveness. Keeping DB_E_ASYNCNOTSUPPORTED with the method and object state makes this scenario diagnosable instead of reducing it to “database error”.
Retry and recovery
Retry rule for DB_E_ASYNCNOTSUPPORTED: retry synchronously or with a provider that advertises asynchronous binding. A DB_E_ASYNCNOTSUPPORTED 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_ASYNCNOTSUPPORTED, determine whether rows, schema objects or URL resources were partially created or changed.
Do not turn DB_E_ASYNCNOTSUPPORTED into an unbounded retry loop. Preserve cancellation for DB_E_ASYNCNOTSUPPORTED and use a fresh provider object when the failed call may have left local state ambiguous.
Difference from nearby HRESULT values
DB_E_NOTSUPPORTED is general method capability failure, while DB_E_ASYNCNOTSUPPORTED specifically rejects asynchronous binding. Telemetry and remediation for DB_E_ASYNCNOTSUPPORTED should keep these outcomes distinct.
Developer and operations guidance
Code handling DB_E_ASYNCNOTSUPPORTED 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_ASYNCNOTSUPPORTED, 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_ASYNCNOTSUPPORTED should group by provider version, interface, method and normalized failure stage. A DB_E_ASYNCNOTSUPPORTED event must not expose passwords, tokens, full connection strings, unrestricted command text or raw row contents.
Official Microsoft references
- Microsoft: direct binding in OLE DB — official documentation relevant to
DB_E_ASYNCNOTSUPPORTED. - Microsoft: OLE DB root binder object — official documentation relevant to
DB_E_ASYNCNOTSUPPORTED. - Microsoft: OLE DB row objects — official documentation relevant to
DB_E_ASYNCNOTSUPPORTED.
Looking for a different code? Search another status or error code.