Eintragungen

Ein Ressourcen-Manager nimmt eine Transaktion auf, wenn er mit der Teilnahme an dieser bestimmten Transaktion beginnt. Die Eintragung definiert, welche Benachrichtigungen der Ressourcen-Manager akzeptiert. Ein Ressourcen-Manager erstellt ein Eintragungsobjekt, wenn er in eine Transaktion einträgt. Dieses Objekt signalisiert KTM, dass der Ressourcen-Manager (RM) Benachrichtigungen über die angegebene Transaktion an fordert.

Der RM stellt eine _ BENACHRICHTIGUNGSMASKEnstruktur zur Verfügung, die die Benachrichtigungen anfing, die er anfing.

Eintragungsfunktionen

Die folgenden Funktionen werden mit Eintragungen verwendet.

Funktion Beschreibung
CommitComplete Gibt an, dass ein Ressourcen-Manager (RM) das Committen einer Transaktion abgeschlossen hat, die vom Transaktions-Manager (TM) angefordert wurde.
CreateEnlistment Erstellt eine Eintragung, legt ihren Anfangszustand fest und öffnet ein Handle für die Eintragung mit dem angegebenen Zugriff.
GetEnlistmentRecoveryInformation Ruft eine nicht transparente Struktur von Wiederherstellungsdaten aus KTM ab. Wiederherstellungsinformationen werden im Namen eines Ressourcen-Managers (RM) in einem Protokoll gespeichert, indem die SetEnlistmentRecoveryInformation-Funktion aufruft. Nach einem Fehler kann der RM die GetEnlistmentRecoveryInformation-Funktion verwenden, um die Informationen abzurufen.
OpenEnlistment Öffnet ein vorhandenes Eintragungsobjekt und gibt ein Handle an die Eintragung zurück.
ReadOnlyEnlistment Fordert an, dass die angegebene Eintragung in eine schreibgeschützte Eintragung konvertiert wird. Eine schreibgeschützte Eintragung kann nicht am Ergebnis der Transaktion teilnehmen und wird nicht dauerhaft für die Wiederherstellung aufgezeichnet.
RollbackEnlistment Führt ein Rollback für die angegebene Transaktion aus, die einer Eintragung zugeordnet ist. Diese Funktion kann nicht für schreibgeschützte Eintragungen aufgerufen werden.
SetEnlistmentRecoveryInformation Legt eine nicht transparente, benutzerdefinierte Struktur von Wiederherstellungsdaten aus KTM fest. Wiederherstellungsinformationen werden im Namen eines Ressourcen-Managers (RM) in einem Protokoll gespeichert, indem SetEnlistmentRecoveryInformation aufruft. Nach einem Fehler kann der RM getEnlistmentRecoveryInformation verwenden, um die Informationen abzurufen.
SinglePhaseReject Gibt an, dass der Ressourcen-Manager (RM) eine einphasenbasierte Anforderung ablehnt. Wenn ein Transaktions-Manager (TM) diesen Aufruf empfängt, initiiert er einen zweiphasenbasierten Commit und sendet eine Vorbereitungsanforderung an alle eingetragenen RMs.