MDAC 2.5 SDK - OLE DB Programmer's Reference
OLE DB Interfaces


 

ITransactionOptions::SetOptions

Sets a suite of options associated with a transaction.

HRESULT SetOptions(
   XACTOPT * pOptions);

Parameters

pOptions

[in]
A pointer to an XACTOPT structure containing the options to be set in this transaction. This cannot be a null pointer.

   typedef struct XACTOPT {
      ULONG           ulTimeout;
      unsigned char   szDescription[MAX_TRAN_DESC];
   } XACTOPT

The elements of this structure are used as described in the following table.

Element Description
ulTimeout The amount of real time in milliseconds before the transaction is to be aborted automatically. Zero indicates an infinite time-out. If no options have been previously set, ulTimeout is zero.
szDescription A pointer to a textual description associated with this transaction. This string is appropriate for display in various end-user administration tools that might monitor or log the transaction. If no options have been previously set, szDescription is an empty string.

Return Code

S_OK

The method succeeded.

E_FAIL

A provider-specific error occurred.

E_INVALIDARG

pOptions was a null pointer.

E_UNEXPECTED

An unknown error occurred; the method failed.

See Also

ITransactionLocal::StartTransaction, ITransactionOptions::GetOptions