RenameTransactionManager-Funktion (ktmw32.h)

Benennt ein Transaktions-Manager-Objekt (TM) um. Diese Funktion kann nur für benannte TM-Handles verwendet werden. Eine neue GUID für das TM ist ausgewählt und kann mithilfe der GetTransactionManagerID-Funktion abgerufen werden.

Syntax

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

Parameter

[in] LogFileName

Der Name des Protokolldatenstroms. Dieser Stream muss in einer CLFS-Protokolldatei vorhanden sein.

[in] ExistingTransactionManagerGuid

Ein -Wert, der den aktuellen Namen des TM angibt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie die GetLastError-Funktion auf.

Die folgende Liste identifiziert die möglichen Fehlercodes:

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista mit SP1
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile ktmw32.h
Bibliothek KtmW32.lib
DLL KtmW32.dll

Weitere Informationen

GetTransactionManagerID

Kerneltransaktions-Manager-Funktionen