Share via


ITipHelper::Pull

 

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

This method returns an ITransaction pointer to the transaction object created corresponding to the transaction identified by the TIP Transaction URL pszTxUrl. pszTxUrl can refer to either a transaction on the applications local TM or a transaction on a remote TIP TM. In the former case, the local TM expects the transaction to exist in its data structures. In the latter case, the local TM will check to determine whether the transaction was pulled at some earlier time; if not, it will send a TIP pull message to the remote TIP TM.

Note

The TIP service feature is deprecated. The TIP service feature and all related APIs are available for use in the operating systems listed in the Requirements sections of the reference topics for those APIs. They might be unavailable in subsequent versions of the operating system. You might consider using the WS-AtomicTransaction (WS-AT) protocol as a replacement transaction coordination and propagation technology. WS-AT support is provided through Windows Communication Foundation (WCF) as part of the .Net Framework. For more information about WS-AT support in the .Net Framework see Transactions.

Syntax

  
      HRESULT Pull( char * pszTxUrl,   
  ITransaction ** ppITransaction  
);  

Parameters

pszTxUrl
[in] Specifies the TIP Transaction URL of the transaction to pull.

ppITransaction
[out] Returns an ITransaction pointer to the transaction object corresponding to the transaction identified by pszTxUrl.

Return Values

S_OK
Success—the transaction pull completed.

E_OUTOFMEMORY
Failure—out of resources.

E_INVALIDARG
Failure—one or more of the parameters are not valid.

E_FAIL
Failure—generic failure while pulling the transaction from the remote transaction manager.

E_UNEXPECTED
Failure—an unexpected error occurred.

XACT_E_TMNOTAVAILABLE
Failure—unable to establish a connection with the DTC service.

XACT_E_CONNECTION_DOWN
Failure—the connection to the local transaction manager is down.

XACT_E_CONNECTION_DENIED
Failure—the transaction manager refused to accept a connection.

XACT_E_LOGFULL
Failure—the transaction manager's log is full.

XACT_E_TIP_DISABLED
Failure—the Transaction Internet Protocol (TIP) service is disabled by default.

XACT_E_TIP_CONNECT_FAILED
Failure—the Transaction Internet Protocol (TIP) gateway lost the TCP/IP connection.

XACT_E_NOTRANSACTION
Failure—the transaction has already been implicitly or explicitly committed or aborted.

XACT_E_TIP_PULL_FAILED
Failure—the transaction manager could not propagate a transaction from another TIP transaction manager.

XACT_E_TIP_PROTOCOL_ERROR
Failure—the transaction manager encountered a protocol error with another TIP transaction manager.

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 txcoord.h

See Also

ITipTransaction
ITipPullSink