2.2.3.4.9 XATMUSER_MTAG_ENLIST

  • Article

The XATMUSER_MTAG_ENLIST message enlists an XA Resource Manager into a transaction.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

MsgHeader (24 bytes)

...

...

guidRm (16 bytes)

...

...

Xid (140 bytes)

...

...

lenImportCookie

ImportCookie (variable)

...

MsgHeader (24 bytes): This field MUST contain a MESSAGE_PACKET structure:

  • The dwUserMsgType field MUST be 0x40000001.

  • The dwcbVarLenData field MUST be greater than 160 (160 bytes, plus the amount for the import cookie member).

guidRm (16 bytes): This field MUST contain a GUID that specifies a resource manager identifier of the XA Resource Manager applying to enlist. There MUST be an open XA Resource Manager that is identified by this resource manager identifier.

Xid (140 bytes): This field MUST contain an XA_XID structure that specifies an XA Transaction Branch Identifier.

lenImportCookie (4 bytes): A 32-bit unsigned integer that MUST contain the size, in bytes, of the import cookie, which is used to determine the transaction in which to enlist.

ImportCookie (variable): This field MUST be a STxInfo structure that specifies the transaction to enlist in. It is present only if the value of the lenImportCookie is nonzero.