支持分布式事务

SQL Server Native Client OLE DB 访问接口使用者可以使用 ITransactionJoin::JoinTransaction 方法参与由 Microsoft 分布式事务处理协调器 (MS DTC) 协调的分布式事务。

MS DTC 公开 COM 对象,这些对象允许客户端跨各种数据存储的多个连接来启动和参与协调的事务。 为了启动事务,SQL Server Native Client OLE DB 访问接口使用者使用 MS DTC ITransactionDispenser 接口。 ITransactionDispenser 的 BeginTransaction 成员返回分布式事务对象的引用。 使用 JoinTransaction 将此引用传递给 SQL Server Native Client OLE DB 访问接口。

MS DTC 支持对分布式事务的异步提交和中止。 为了通知异步事务状态,使用者实现 ITransactionOutcomeEvents 接口并将该接口与 MS DTC 事务对象连接。

对于分布式事务,SQL Server Native Client OLE DB 访问接口按如下方式实现 ITransactionJoin::JoinTransaction 参数。

参数

说明

punkTransactionCoord

指向 MS DTC 事务对象的指针。

IsoLevel

被 SQL Server Native Client OLE DB 访问接口忽略。 使用者在从 MS DTC 获取事务对象时,确定由 MS DTC 协调的事务的隔离级别。

IsoFlags

必须为 0。 如果使用者指定了任何其他值,SQL Server Native Client OLE DB 访问接口将返回 XACT_E_NOISORETAIN。

POtherOptions

如果不是 NULL,SQL Server Native Client OLE DB 访问接口将从该接口请求选项对象。 如果选项对象的 ulTimeout 成员不为零,则 SQL Server Native Client OLE DB 访问接口返回 XACT_E_NOTIMEOUT。 SQL Server Native Client OLE DB 访问接口忽略 szDescription 成员的值。

下面的示例通过使用 MS DTC 来协调事务:

// Interfaces used in the example.
IDBCreateSession*       pIDBCreateSession   = NULL;
ITransactionJoin*       pITransactionJoin   = NULL;
IDBCreateCommand*       pIDBCreateCommand   = NULL;
IRowset*                pIRowset            = NULL;

// Transaction dispenser and transaction from MS DTC.
ITransactionDispenser*  pITransactionDispenser = NULL;
ITransaction*           pITransaction       = NULL;

    HRESULT             hr;

// Get the command creation interface for the session.
if (FAILED(hr = pIDBCreateSession->CreateSession(NULL,
     IID_IDBCreateCommand, (IUnknown**) &pIDBCreateCommand)))
    {
    // Process error from session creation. Release any references and
    // return.
    }

// Get a transaction dispenser object from MS DTC and
// start a transaction.
if (FAILED(hr = DtcGetTransactionManager(NULL, NULL,
    IID_ITransactionDispenser, 0, 0, NULL,
    (void**) &pITransactionDispenser)))
    {
    // Process error message from MS DTC, release any references,
    // and then return.
    }
if (FAILED(hr = pITransactionDispenser->BeginTransaction(
    NULL, ISOLATIONLEVEL_READCOMMITTED, ISOFLAG_RETAIN_DONTCARE,
    NULL, &pITransaction)))
    {
    // Process error message from MS DTC, release any references,
    // and then return.
    }

// Join the transaction.
if (FAILED(pIDBCreateCommand->QueryInterface(IID_ITransactionJoin,
    (void**) &pITransactionJoin)))
    {
    // Process failure to get an interface, release any references, and
    // then return.
    }
if (FAILED(pITransactionJoin->JoinTransaction(
    (IUnknown*) pITransaction, 0, 0, NULL)))
    {
    // Process join failure, release any references, and then return.
    }

// Get data into a rowset, then update the data. Functions are not
// illustrated in this example.
if (FAILED(hr = ExecuteCommand(pIDBCreateCommand, &pIRowset)))
    {
    // Release any references and return.
    }

// If rowset data update fails, then terminate the transaction, else
// commit. The example doesn't retain the rowset.
if (FAILED(hr = UpdateDataInRowset(pIRowset, bDelayedUpdate)))
    {
    // Get error from update, then abort.
    pITransaction->Abort(NULL, FALSE, FALSE);
    }
else
    {
    if (FAILED(hr = pITransaction->Commit(FALSE, 0, 0)))
        {
        // Get error from failed commit.
        //
        // If a distributed commit fails, application logic could
        // analyze failure and retry. In this example, terminate. The 
        // consumer must resolve this somehow.
        pITransaction->Abort(NULL, FALSE, FALSE);
        }
    }

if (FAILED(hr))
    {
    // Update of data or commit failed. Release any references and
    // return.
    }

// Un-enlist from the distributed transaction by setting 
// the transaction object pointer to NULL.
if (FAILED(pITransactionJoin->JoinTransaction(
    (IUnknown*) NULL, 0, 0, NULL)))
    {
    // Process failure, and then return.
    }

// Release any references and continue.

请参阅

概念

事务