GetTransactionInformation function

Returns the requested information about the specified transaction.

Syntax


BOOL WINAPI GetTransactionInformation(
  _In_       HANDLE TransactionHandle,
  _Out_opt_  PDWORD Outcome,
  _Out_opt_  PDWORD IsolationLevel,
  _Out_opt_  PDWORD IsolationFlags,
  _Out_opt_  PDWORD Timeout,
  _In_       DWORD BufferLength,
  _Out_opt_  LPWSTR Description
);

Parameters

TransactionHandle [in]

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

Outcome [out, optional]

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.

IsolationLevel [out, optional]

Reserved.

IsolationFlags [out, optional]

Reserved.

Timeout [out, optional]

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

BufferLength [in]

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

Description [out, optional]

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:

ERROR_ACCESS_DENIED
ERROR_INVALID_HANDLE
ERROR_INSUFFICIENT_RESOURCES
ERROR_TRANSACTION_ALREADY_ABORTED

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Ktmw32.h

Library

Ktmw32.lib

DLL

Ktmw32.dll

See also

CreateTransaction
Kernel Transaction Manager Functions
SetTransactionInformation

 

 

Community Additions

ADD
Show:
© 2014 Microsoft