xa_rollback
Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista
Called by the XA-based transaction manager or any XA application that performs operations on a SQL Server database by using the XA interfaces, to roll back work done on behalf of a transaction branch.
| Implemented by: | MSDTC |
| Object | This is a helper function, not a method on an object. |
| Interface Source | N/A |
| Called by: | XA-based transaction manager. |
Syntax
int __cdecl xa_rollback ( __in XID *xid, int rmid, long flags);
Parameters
xid
[in] Specifies the XA Transaction Branch Identifier.
rmid
[in] Resource Manager ID.
flags
[in] Flags defined in [XAOpen – DTP] Chapter 4.4.
Return Values
Return code defined in Chapter 4.5 of [XAOpen – DTP].
Remarks
When a transaction manager or XA application calls xa_rollback for the transaction branch identified by the xid parameter, any changes made to resources held during the transaction branch are rolled back to the state they were in at the start of the transaction branch and the resources are released. The xa_rollback function must be called for each transaction branch that accessed the resource manager on behalf of a distributed transaction.
Requirements
For an explanation of the requirement values, see Requirements (Component Services).
Platforms: Windows Server 2016, Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista
Header: Declared in xa.h