The GetTransactionInfo method retrieves information about the transaction represented by its TransactionImpl (section 3.8) instance.

 HRESULT GetTransactionInfo(
   [out] XACTTRANSINFO* pinfo
 );

pinfo: A pointer to the caller-allocated XACTTRANSINFO structure in which the method returns information about the transaction.

Return Values: The method MUST return S_OK (0x00000000) to indicate success or an implementation-specific error HRESULT on failure.<32>

When the server processes this call, it MUST follow these guidelines:

• If the pinfo output variable is NULL:

  • Return an error HRESULT, and take no further action.

• If the isInternal instance variable is True:

  • Set the uow property of the pinfo output variable to the value of the TransactionIdentifier instance variable.

  • Set all the remaining properties of the pinfo output variable to 0.

• Else:

  • Set the uow property of the pinfo output variable to the value of the TransactionIdentifier instance variable.

  • Send a request to the distributed transaction manager to retrieve the transaction details by using the TransactionIdentifier instance variable. For more details about this request, refer to [MS-DTCO] section 2.2.8.3.1.1.

  • Set the remaining properties of the pinfo output variable to the values obtained from the preceding request.