What does HRESULT 0x00040ED9 (DB_S_PROPERTIESCHANGED) mean?

DB_S_PROPERTIESCHANGED

OLE DB provider adjusted requested properties

DB_S_PROPERTIESCHANGED is HRESULT 265945 (0x00040ED9) from Microsoft OLE DB. The documented description is “One or more properties were changed as allowed by provider.” The high-order severity bit is clear, so this is a success result, but it carries more information than plain S_OK.

One or more properties were changed to values permitted by the provider rather than applied exactly as requested.

Evidence to preserve

• Preserve property set GUID and property IDs.
• Preserve requested values and options.
• Preserve DBPROPSTATUS values.
• Preserve effective properties.
• Preserve provider version and initialization phase.

Where the result is encountered

• This result can appear in IDBProperties or rowset property negotiation; record the producing interface and method.
• This result can appear in initialization settings; record the producing interface and method.
• It can appear in requests containing optional and required property values; record the producing interface and method.

State to verify

The central question is whether the caller inspects each property status and reads back effective values before using the object.

Diagnostic sequence

• Capture the raw HRESULT 0x00040ED9 immediately after the returning method and record whether the caller used SUCCEEDED, FAILED, equality testing, or exception translation.
• Verify the method-specific state: the caller inspects each property status and reads back effective values before using the object.

Difference from nearby HRESULT values

DB_S_GOALCHANGED identifies a clamped goal or weight; it is the general property-adjustment result.

Correct handling, retry, and recovery

Accept only changes compatible with the application. Fail early for required properties; adapt optional behavior to the effective values.

Practical validation scenario

A rowset requests bookmarks and a specific cursor behavior. The provider adjusts one optional property; the consumer reads back both values and disables bookmark-based UI when unsupported.

Developer and administrator guidance

References

• Microsoft: OLE DB return codes
• Microsoft: OLE DB Driver return codes
• Microsoft: OLE DB error records