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 la restauration de la transaction spécifiée.
rollbackTransactionAsync	Demande la restauration de la transaction spécifiée. Cette fonction retourne de façon asynchrone.
SetTransactionInformation	Définit les informations de transaction pour la transaction spécifiée.

 

Les fonctions suivantes sont utilisées avec des inscriptions.

Fonction	Description
commitComplete	Indique qu’un RM 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 à l’inscription avec l’accès spécifié.
GetEnlistmentRecoveryInformation	Récupère une structure opaque 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 la fonction SetEnlistmentRecoveryInformation. Après un échec, 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 la tm supérieure pour indiquer que leurs travaux pré-préparés ont été terminés.
PrePrepareEnlistment	Appelé par la tm supérieure pour indiquer que leurs travaux pré-préparés ont été terminés.
RecoverEnlistment	Récupère l’état d’un inscription.
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 à une inscription. 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 au nom d’un RM en appelant SetEnlistmentRecoveryInformation. Après un échec, rm peut utiliser GetEnlistmentRecoveryInformation pour récupérer les informations.
SinglePhaseReject	Indique que le RM refuse une demande en phase unique. 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 rm à un gestionnaire de transactions (TM).
GetNotificationResourceManager	Demande et reçoit une notification pour RM. Cette fonction est utilisée par l’inscription 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 traitement nécessaire pour garantir qu’une opération de validation ou d’abandon réussit pour la transaction spécifiée.
PrePrepareComplete	Signale que ce RM a terminé son travail de préprepare, 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 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 le TM spécifié.
OpenTransactionManager	Ouvre une tm existante.
OpenTransactionManagerById	Ouvre une tm existante.
RecoverTransactionManager	Récupère l’état d’un 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.