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 TM URL identifying the application's OLE Transaction TM. The TIP TM URL identifies the TM in a network of computers. It is of the form "tip://<tcp-ip endpoint>/<path>". For example, "tip://www.microsoft.com:4321/" would be a valid TIP TM URL for a transaction manager running on the server "www.microsoft.com" listening for TIP requests on port 4321.
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.
HRESULT GetLocalTmUrl( char ** ppszLocalTmUrl );
[out] This parameter returns the TIP TM URL of the application's Transaction Manager. The application must free this parameter by calling CoTaskMemFree after it is finished using it.
Success—the TIP TM URL was returned.
Failure—out of resources.
Failure—one or more of the parameters are not valid.
Failure—generic failure while attempting to get the local TM's TIP TM URL.
Failure—an unexpected error occurred.
Failure—the Transaction Internet Protocol (TIP) service is disabled by default.
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