Fonctions du gestionnaire de transactions du noyau

  • Article

Les fonctions suivantes sont utilisées avec les transactions.

Fonction Description
CommitTransaction Demande que la transaction spécifiée soit validée.
CommitTransactionAsync Demande que la transaction spécifiée soit validée.
CreateTransaction Crée un objet de transaction.
GetTransactionId Obtient l’ID de la transaction spécifiée.
GetTransactionInformation Retourne les informations demandées sur la transaction spécifiée.
OpenTransaction Ouvre une transaction existante.
RollbackComplete Indique que le gestionnaire de ressources (RM) a terminé la restauration d’une transaction.
RollbackTransaction Demande que la transaction spécifiée soit restaurée.
RollbackTransactionAsync Demande que la transaction spécifiée soit restaurée. Cette fonction retourne de manière asynchrone.
SetTransactionInformation Définit les informations de transaction pour la transaction spécifiée.

 

Les fonctions suivantes sont utilisées avec les inscriptions.

Fonction Description
CommitComplete Indique qu’un gestionnaire de transactions a terminé la validation d’une transaction demandée par le gestionnaire de transactions (TM).
CommitEnlistment Valide la transaction pour l’inscription spécifiée.
GetEnlistmentId Obtient l’ID de l’inscription spécifiée.
CreateEnlistment Crée une inscription, définit son état initial et ouvre un handle pour l’inscription avec l’accès spécifié.
GetEnlistmentRecoveryInformation Récupère une structure opaque de données de récupération à partir de KTM. Les informations de récupération sont stockées dans un journal pour le compte d’un RM en appelant la fonction SetEnlistmentRecoveryInformation . Après un échec, le RM peut utiliser la fonction GetEnlistmentRecoveryInformation pour récupérer les informations.
OpenEnlistment Ouvre un objet d’inscription existant et retourne un handle à l’inscription.
PrepareEnlistment Appelé par tm supérieur pour indiquer que leur travail de pré-préparation a été terminé.
PrePrepareEnlistment Appelé par tm supérieur pour indiquer que leur travail de pré-préparation a été terminé.
RecoverEnlistment Récupère l’état d’un enrôlement.
ReadOnlyEnlistment Demande que l’inscription spécifiée soit convertie en inscription en lecture seule. Une inscription en lecture seule ne peut pas participer au résultat de la transaction et n’est pas enregistrée durablement pour la récupération.
RollbackEnlistment Restaure la transaction spécifiée associée à un enrôlement. Cette fonction ne peut pas être appelée pour les inscriptions en lecture seule.
SetEnlistmentRecoveryInformation Définit une structure opaque définie par l’utilisateur des données de récupération à partir de KTM. Les informations de récupération sont stockées dans un journal pour le compte d’un RM en appelant SetEnlistmentRecoveryInformation. Après un échec, le RM peut utiliser GetEnlistmentRecoveryInformation pour récupérer les informations.
SinglePhaseReject Indique que le RM refuse une requête monophase. Lorsqu’un tm reçoit cet appel, il lance une validation en deux phases et envoie une demande de préparation à toutes les machines virtuelles inscrites.

 

Les fonctions suivantes sont utilisées avec les gestionnaires de ressources.

Fonction Description
CreateResourceManager Crée un objet RM et associe le RM à un gestionnaire de transactions (TM).
GetNotificationResourceManager Demande et reçoit une notification pour RM. Cette fonction est utilisée par le registre RM pour recevoir des notifications lorsqu’une transaction change d’état.
GetNotificationResourceManagerAsync Demande et reçoit une notification asynchrone pour un RM. Cette fonction est utilisée par le RM pour s’inscrire pour recevoir des notifications lorsqu’une transaction change d’état.
OpenResourceManager Ouvre un RM existant.
PrepareComplete Indique que le RM a terminé tout le traitement nécessaire pour garantir qu’une opération de validation ou d’abandon réussit pour la transaction spécifiée.
PrePrepareComplete Indique que ce RM a terminé son travail de préparation, afin que d’autres machines virtuelles puissent maintenant commencer leurs opérations de préparation.
RecoverResourceManager Récupère l’état d’un RM à partir de son fichier journal.
SetResourceManagerCompletionPort Associe le port d’achèvement d’E/S spécifié au RM spécifié. Ce port reçoit toutes les notifications pour le RM.

 

Les fonctions suivantes sont utilisées avec les gestionnaires de transactions.

Fonction Description
CreateTransactionManager Crée un objet TM et retourne un handle avec l’accès spécifié.
GetCurrentClockTransactionManager Obtient une valeur d’horloge virtuelle à partir d’une tm.
GetTransactionManagerId Obtient un identificateur pour la TM spécifiée.
OpenTransactionManager Ouvre une tm existante.
OpenTransactionManagerById Ouvre une tm existante.
RecoverTransactionManager Récupère l’état d’une TM à partir de son fichier journal.
RenameTransactionManager Renomme un TM.
RollforwardTransactionManager Récupère l’état de TM de son fichier journal à la valeur d’horloge virtuelle spécifiée.