Obsługi transakcji rozproszonych
SQL Server Konsumenci macierzystego dostawca klient OLE DB, można użyć ITransactionJoin::JoinTransaction metoda uczestniczyć w transakcja rozproszona koordynowane przez Microsoft transakcja rozproszona Coordinator (MS DTC).
Usługa MS DTC umożliwia uzyskanie dostępu do obiektów COM, który pozwala klientom na inicjowanie i uczestniczenie w transakcjach koordynowane przez wiele połączeń z różnymi magazynami danych.Aby zainicjować transakcję, SQL Server Konsument macierzystego dostawca klient OLE DB korzysta z usługi MS DTC ITransactionDispenser interfejs.The BeginTransaction element członkowski of ITransactionDispenser returns a reference on a transakcja rozproszona object.To odwołanie jest przekazywany do SQL Server Za pomocą macierzystego dostawca klient OLE DB JoinTransaction.
Usługi MS DTC obsługuje asynchroniczny zatwierdzanie i przerwania w transakcjach rozproszonych.Dla powiadomienie w stan asynchronicznego implementuje konsumenta ITransactionOutcomeEvents interfejs i łączy się z interfejsem obiekt transakcji MS DTC.
Dla transakcji rozproszonych SQL Server Implementuje macierzystego dostawca klient OLE DB ITransactionJoin::JoinTransaction parametrów w następujący sposób.
Parameter |
Description |
|---|---|
punkTransactionCoord |
Wskaźnik na obiekt transakcji MS DTC. |
IsoLevel |
Ignorowane przez SQL Server Macierzystego dostawca klient OLE DB. Poziom izolacji transakcji koordynuje usługi MS jest określana w momencie, gdy konsument nabywa obiektu transakcji z usługi MS DTC. |
IsoFlags |
Musi mieć wartość 0.The SQL Server Native klient OLE DB dostawca returns XACT_E_NOISORETAIN if any other value is specified by the consumer. |
POtherOptions |
Jeśli nie jest NULL, SQL Server Macierzystego dostawca klient OLE DB żąda obiektu opcji z interfejs. The SQL Server Native klient OLE DB dostawca returns XACT_E_NOTIMEOUT if the options object's ulTimeout element członkowski is not zero.The SQL Server Native klient OLE DB dostawca ignores the value of the szDescription element członkowski. |
W tym przykładzie koordynuje transakcji za pomocą usługi 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.