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. |