ITipHelper::GetLocalTmUrl
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.
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 GetLocalTmUrl( char ** ppszLocalTmUrl
);
Parameters
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.
Return Values
S_OK
Success—the TIP TM 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 while attempting to get the local TM's TIP TM URL.
E_UNEXPECTED
Failure—an unexpected error occurred.
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