| Previous | Next |
| XACT_S_MADECHANGESCONTENT | XACT_S_ALLNORETAIN |
XACT_S_MADECHANGESINFORM
Transaction sink changed resources and wants another look
XACT_S_MADECHANGESINFORM is HRESULT 315398 (0x0004D006) from winerror.h. AllStat describes it as “The sink is for the moment and wishes the transaction to proceed, but if other changes are made following this return by other event sinks then this sink wants another chance to look.” The severity bit indicates a nonfailure result, but the value carries a specific condition that must not be collapsed into plain S_OK.
In the COM transaction and MSDTC protocol, this result means that the sink is for the moment and wishes the transaction to proceed, but if other changes are made following this return by other event sinks then this sink wants another chance to look. Before reporting completion for this HRESULT, the caller must reconcile the code-specific state transition and every usable output.
What must be true before accepting it
Verify that the sink’s changes are included and it is recalled if subsequent sinks modify relevant state. Without that proof, this result can mask a caller error even though HRESULT failure severity is not set.
Reconcile side effects associated with this result before compensation or a second invocation is attempted.
Where the status is encountered
- This result can be returned during ITransaction commit or abort processing; log the exact method and object state instead of interpreting the constant outside that contract.
- It can be returned during resource-manager enlistment and coordinated outcomes; log the exact method and object state instead of interpreting the constant outside that contract.
- It can be returned during transaction event-sink notification passes; log the exact method and object state instead of interpreting the constant outside that contract.
Because it is informational, a language binding may expose it as success and hide the symbolic distinction. Keep the original HRESULT available until the code-specific branch has run.
Evidence and telemetry
- preserve sink order and generation.
- preserve resources changed by this sink.
- preserve later sink changes.
- preserve inform-pass count.
- preserve convergence or cycle detection.
Also record xact_s_madechangesinform_operation, xact_s_madechangesinform_state_before, xact_s_madechangesinform_state_after, UTC time, process and thread identifiers, component version, and a correlation ID. Telemetry for this HRESULT should omit credentials while retaining nonsecret object identities and version data.
Correct handling and recovery
Track change generations and schedule another inform pass only after a later modification. Protect against endless mutual changes between sinks.
Retry it only when a documented input or state has changed. An unchanged retry after it is useful only when the API explicitly advances through repeated calls.
Practical scenario
Two policy sinks adjust related values. The first returns this status, is recalled after the second changes state, and confirms the combined values converge.
A regression test should reproduce it, assert the relevant outputs and state, then change only the decisive condition and verify the expected neighboring result or ordinary completion.
Difference from nearby results
It must be distinguished from ordinary S_OK and from failure-severity values in the same API family; its documented state changes control the next action.
Correctly separating it from neighboring values selects the proper continuation and cleanup path.
References
- Microsoft: COM transaction status codes — official Microsoft material used to interpret it.
- Microsoft: ITransaction::Commit
- Microsoft: ITransaction::Abort
- Microsoft: HRESULT values
Looking for a different code? Search another status or error code.