Fonctions du gestionnaire de transactions du noyau

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.