| Previous | Next |
| XACT_S_ABORTING | XACT_S_LOCALLY_OK |
XACT_S_SINGLEPHASE
Resource manager performed a single-phase commit
XACT_S_SINGLEPHASE is HRESULT 315401 (0x0004D009) from winerror.h. The documented description is “The resource manager has performed a single-phase commit of the transaction.” 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 resource manager has performed a single-phase commit of the transaction. The high-level request can be considered complete after it only when its documented postcondition has been checked.
Where the status is encountered
- ITransaction commit or abort processing; log the exact method and object state instead of interpreting the constant outside that contract.
- Resource-manager enlistment and coordinated outcomes; log the exact method and object state instead of interpreting the constant outside that contract.
- Transaction event-sink notification passes; log the exact method and object state instead of interpreting the constant outside that contract.
Evidence to preserve
- Preserve resource manager identity.
- Preserve enlistment count.
- Preserve single-phase eligibility.
- Preserve durable commit record.
- Preserve coordinator completion status.
What must be true before accepting it
Verify that the single-phase optimization is permitted and the resource manager’s durable result is authoritative. The verification prevents it from being promoted to broader success than the producing API promised.
Correct handling and recovery
Record the optimization and final resource result. Do not attempt a second prepare or commit; handle recovery according to the resource manager’s single-phase contract.
Retry policy must follow the owning state machine rather than a generic transient-error loop.
Difference from nearby results
The nearby-status comparison controls whether outputs are usable and whether more work is expected.
Practical scenario
A transaction has one durable resource manager, which completes single-phase commit. The coordinator records the optimized path and closes the unit of work.
References
- Microsoft: COM transaction status codes — official Microsoft material relevant to this HRESULT.
- Microsoft: ITransaction::Commit
- Microsoft: ITransaction::Abort
- Microsoft: HRESULT values
Looking for a different code? Search another status or error code.