ITipTransaction::GetTransactionURL
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
The application calls this method to get the TIP Transaction URL identifying the transaction object. The TIP Transaction URL identifies the transaction in a network of computers. It is of the form "tip://<tcp-ip endpoint>/<path>?<transaction identifier in ASCII>". For example, "tip://www.microsoft.com/?oletx-0000000-0000-0000-0000-000000000001" would be a valid TIP Transaction URL for a transaction object with the identifier "0000000-0000-0000-0000-000000000001" created by a DTC service running on the server "www.microsoft.com". The previous example assumes that the DTC service is listening for a TIP request on the default transaction service port number. This port number is defined in the TIP specification.
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 GetTransactionUrl( char ** ppszLocalTxUrl);
Parameters
ppszLocalTxUrl
[out] This parameter returns the TIP Transaction URL identifying the transaction object. The application must free this parameter by calling CoTaskMemFree after it is finished using it.
Return Values
S_OK
Success—the TIP Transaction URL was returned.
E_OUTOFMEMORY
Failure—out of resources.
E_INVALIDARG
Failure—one or more of the parameters are not valid.
E_FAIL
Failure—generic failure occurred while trying to get the TIP Transaction URL of the transaction specified.
E_UNEXPECTED
Failure—an unexpected error occurred.
XACT_E_NOTRANSACTION
Failure—the transaction has already committed or aborted.
XACT_E_TIP_DISABLED
Failure—the Transaction Internet Protocol (TIP) service is disabled by default.
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