GetTransactionInformation function (ktmw32.h)

Returns the requested information about the specified transaction.

Syntax

BOOL GetTransactionInformation(
  [in]            HANDLE TransactionHandle,
  [out, optional] PDWORD Outcome,
  [out, optional] PDWORD IsolationLevel,
  [out, optional] PDWORD IsolationFlags,
  [out, optional] PDWORD Timeout,
  [in]            DWORD  BufferLength,
  [out, optional] LPWSTR Description
);

Parameters

[in] TransactionHandle

A handle to the transaction. The handle must have the TRANSACTION_QUERY_INFORMATION permission to retrieve the information.

[out, optional] Outcome

A pointer to a buffer that receives the current outcome of the transaction. If the call to the GetTransactionInformation function is successful, this value will be one of the TRANSACTION_OUTCOME enumeration values.

[out, optional] IsolationLevel

Reserved.

[out, optional] IsolationFlags

Reserved.

[out, optional] Timeout

A pointer to a variable that receives the timeout value, in milliseconds, for this transaction.

[in] BufferLength

The size of the Description parameter, in bytes. The buffer length value cannot be longer than the value of MAX_TRANSACTION_DESCRIPTION_LENGTH.

[out, optional] Description

A pointer to a buffer that receives the user-defined description of the transaction.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call the GetLastError function.

The following list identifies the possible error codes:

Requirements

   
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header ktmw32.h
Library Ktmw32.lib
DLL Ktmw32.dll

See also

CreateTransaction

Kernel Transaction Manager Functions

SetTransactionInformation