Функция GetTransactionInformation (ktmw32.h)

Статья
08/24/2023

Возвращает запрошенные сведения об указанной транзакции.

Синтаксис

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
);

Параметры

[in] TransactionHandle

Дескриптор транзакции. Дескриптор должен иметь разрешение TRANSACTION_QUERY_INFORMATION для получения сведений.

[out, optional] Outcome

Указатель на буфер, который получает текущий результат транзакции. Если вызов функции GetTransactionInformation выполнен успешно, это значение будет одним из TRANSACTION_OUTCOME значений перечисления.

[out, optional] IsolationLevel

Зарезервировано.

[out, optional] IsolationFlags

Зарезервировано.

[out, optional] Timeout

Указатель на переменную, которая получает значение времени ожидания (в миллисекундах) для этой транзакции.

[in] BufferLength

Размер параметра Description в байтах. Длина буфера не может быть больше значения MAX_TRANSACTION_DESCRIPTION_LENGTH.

[out, optional] Description

Указатель на буфер, получающий пользовательское описание транзакции.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Чтобы получить расширенные сведения об ошибке, вызовите функцию GetLastError .

В следующем списке указаны возможные коды ошибок:

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	ktmw32.h
Библиотека	Ktmw32.lib
DLL	Ktmw32.dll

См. также раздел

CreateTransaction

Функции диспетчера транзакций ядра

SetTransactionInformation

Поделиться через