| Previous | Next |
| DB_E_CANNOTFREE | DB_E_GOALREJECTED |
DB_E_NEWLYINSERTED
Meaning
Windows documents DB_E_NEWLYINSERTED as “Identity cannot be determined for newly inserted rows”. Here, the provider cannot determine stable identity information for a row that has been newly inserted.
Specific conditions that produce the result
- Cause 1: the insert is still pending in deferred-update mode.
- Cause 2: the data source assigns identity only when the change is transmitted.
- Cause 3: the provider cannot produce a bookmark or key for the provisional row.
Relevant OLE DB contract
This result must be interpreted against this contract: OLE DB rowsets own HROW values, fetch position, granted properties and visibility rules; row handles, bookmarks, update state and navigation capabilities remain valid only under the lifetime and generation that produced them.
Start with the current rowset instance, its granted properties and the exact row or position token used by the consumer when investigating this result.
Evidence to collect before changing the system
- Evidence 1: the HROW, update mode and pending status.
- Evidence 2: generated-key, bookmark and identity-column metadata.
- Evidence 3: the Update or transaction step at which permanent identity becomes available.
Corrective actions
- Action 1: complete the pending insert before requesting stable identity.
- Action 2: obtain generated keys through a provider-supported return mechanism.
- Action 3: avoid caching provisional HROW identity as a durable key.
Practical incident
A client inserts a row in delayed mode and immediately asks for a persistent bookmark; calling IRowsetUpdate::Update first prevents it.
Retry and recovery policy
Retry rule: retry after the insert is committed or the provider reports permanent identity.
Difference from related HRESULT values
DB_E_PENDINGINSERT reports that current data for the inserted row is unavailable while pending, whereas it specifically reports that stable row identity cannot yet be determined.
Official Microsoft references
Looking for a different code? Search another status or error code.