RenameTransactionManager function (ktmw32.h)

Renames a transaction manager (TM) object. This function can only be used on named TM handles. A new GUID for the TM is selected and can be retrieved using the GetTransactionManagerID function.

Syntax

BOOL RenameTransactionManager(
  [in] LPWSTR LogFileName,
  [in] LPGUID ExistingTransactionManagerGuid
);

Parameters

[in] LogFileName

The name of the log stream. This stream must exist within a CLFS log file.

[in] ExistingTransactionManagerGuid

A value that specifies the current name of the TM.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero (0). To get extended error information, call the GetLastError function.

The following list identifies the possible error codes:

Requirements

Requirement Value
Minimum supported client Windows Vista with SP1
Minimum supported server Windows Server 2008
Target Platform Windows
Header ktmw32.h
Library KtmW32.lib
DLL KtmW32.dll

See also

GetTransactionManagerID

Kernel Transaction Manager Functions