IResourceManager::Enlist

Prototypes


HRESULT IResourceManager::Enlist(ITransaction *pTransaction, ITransactionResourceAsync *pRes, GUID *pUOW, LONG *pisoLevel, ITransactionEnlistmentAsync **ppEnlist);

Description

Déclare la transaction pTransaction auprès du moniteur transactionnel via l'objet représentant le gestionnaire de ressources courant.

Cette Application Program Interface (API) est utilisée par le moniteur transactionnel pour piloter le gestionnaire de ressources.

Le pilotage du gestionnaire de ressources s'effectue via l'interface pRes. Quand une de ses méthodes est terminée, il faut le signaler au moniteur transactionnel par l'usage de l'interface ppEnlist.

En sortie, l'identifiant de la transaction est rangé dans pUOW et son niveau d'isolement dans pisoLevel.

Pour Up ! Object Management System, la déclaration d'une transaction s'effectue via IUpsOms::ResourceManagerEnlist qui appelle IResourceManager::Enlist.

Le résultat est S_OK en cas de succès.

Exemple


#include <transact.h>

#include <txdtc.h>

#include <xolehlp.h>



static IResourceManager *pIResourceManager;

static ITransaction *pITransaction;

static ITransactionResourceAsync *pITransactionResourceAsync;

static GUID IdentifiantTransaction;

static LONG NiveauIsolement;

static ITransactionEnlistmentASync *pITransactionEnlistmentASync;



...

if (pIResourceManager->Enlist(pTransaction, pITransactionResourceAsync, &IdentifiantTransaction, &NiveauIsolement,
      &pITransactionEnlistmentASync)!=S_OK)

   {

   ...

   }


...

pITransactionEnlistmentASync->AddRef();

Voir aussi

ITransaction pour connaître la classe des transactions. IResourceManager pour connaître la classe du gestionnaire de ressources. ITransactionResourceASync pour connaître l'interface de pilotage des transactions du gestionnaire de ressources. ITransactionEnlistmentAsync pour connaître l'interface de compte-rendu du pilotage des transactions du gestionnaire de ressources.