xa_forget

Prototypes


int xa_forget(XID *xid, int rmid, long flags);

Description

Abandonne la validation de la transaction identifiée par xid, qui a déjà été préparée, pour le gestionnaire de ressources identifié par rmid avec les options flags.

Cette Application Program Interface (API) est fournie par le gestionnaire de ressources au moniteur transactionnel. Ce dernier décide des identifications.

Les valeurs possibles du codage bit de flags sont les suivantes :

TMNOFLAGS.
Pas d'options.
TMASYNC.
Demande de traitement asynchrone.

Les valeurs possibles du code retour sont les suivantes :

XAER_RMERR.
Erreur interne.
XAER_RMFAIL.
Echec.
XAER_ASYNC.
Le mode asynchrone n'est pas supporté.
XAER_INVAL.
Un paramètre possède une valeur invalide.
XAER_NOTA.
xid n'identifie pas une transaction.
XA_OK.
Succès.

Exemple


#include <xa.h>



static int rmid;

static XID xid;

static xa_switch_t *XaSwitch;



...

if ((*XaSwitch->xa_prepare_entry)(&Xid, rmid, TMNOFLAGS)!=XA_OK)

   {

   ...

   }

...

if ((*XaSwitch->xa_forget_entry)(&Xid, rmid, TMNOFLAGS)!=XA_OK)

   {

   ...

   }

...

if ((*XaSwitch->xa_commit_entry)(&Xid, rmid, TMNOFLAGS)!=XA_OK)

   {

   ...

   }

...

if ((*XaSwitch->xa_rollback_entry)(&Xid, rmid, TMNOFLAGS)!=XA_OK)

   {

   ...

   }

...

Voir aussi

xa_prepare pour préparer la validation d'une transaction. xa_commit pour valider une transaction. xa_rollback pour invalider une transaction.