Eintragungen
Ein Ressourcenmanager wird in eine Transaktion aufgenommen, wenn er mit der Teilnahme an dieser bestimmten Transaktion beginnt. Die Liste definiert, welche Benachrichtigungen der Ressourcen-Manager akzeptiert. Ein Ressourcen-Manager erstellt ein Einlistungsobjekt, wenn es sich in eine Transaktion einlistet. Dieses Objekt signalisiert KTM, dass der Ressourcen-Manager (RM) Benachrichtigungen über die angegebene Transaktion anfordert.
Die RM stellt eine NOTIFICATION_MASK Struktur bereit, in der die angeforderten Benachrichtigungen aufgeführt werden.
Die folgenden Funktionen werden mit Enlistments verwendet.
Funktion | BESCHREIBUNG |
---|---|
CommitComplete | Gibt an, dass ein Ressourcen-Manager (RM) das Commit für eine Transaktion abgeschlossen hat, die vom Transaktions-Manager (TM) angefordert wurde. |
CreateEnlistment | Erstellt eine Enlistment, legt ihren Anfangsstatus fest und öffnet ein Handle für die Einlistung mit dem angegebenen Zugriff. |
GetEnlistmentRecoveryInformation | Ruft eine undurchsichtige Struktur von Wiederherstellungsdaten von KTM ab. Wiederherstellungsinformationen werden im Auftrag eines Ressourcen-Managers (RM) in einem Protokoll gespeichert, indem die SetEnlistmentRecoveryInformation-Funktion aufgerufen wird. Nach einem Fehler kann der RM die GetEnlistmentRecoveryInformation-Funktion verwenden, um die Informationen abzurufen. |
OpenEnlistment | Öffnet ein vorhandenes Einlistungsobjekt und gibt ein Handle an die Enlistment zurück. |
ReadOnlyEnlistment | Fordert an, dass die angegebene Liste in eine schreibgeschützte Liste 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 Einlistung zugeordnet ist. Diese Funktion kann nicht für schreibgeschützte Auflistungen aufgerufen werden. |
SetEnlistmentRecoveryInformation | Legt eine undurchsichtige, benutzerdefinierte Struktur von Wiederherstellungsdaten von KTM fest. Wiederherstellungsinformationen werden im Auftrag eines Ressourcen-Managers (RM) in einem Protokoll gespeichert, indem SetEnlistmentRecoveryInformation aufgerufen wird. Nach einem Fehler kann der RM getEnlistmentRecoveryInformation verwenden, um die Informationen abzurufen. |
SinglePhaseReject | Gibt an, dass der Ressourcen-Manager (RM) eine einphasige Anforderung ablehnt. Wenn ein Transaktions-Manager (TM) diesen Aufruf empfängt, initiiert er einen zweiphasigen Commit und sendet eine Vorbereitungsanforderung an alle eingetragenen RMs. |