GetTransactionInformation 函数 (ktmw32.h)

返回有关指定事务的请求信息。

语法

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
标头 ktmw32.h
Library Ktmw32.lib
DLL Ktmw32.dll

另请参阅

CreateTransaction

内核事务管理器函数

SetTransactionInformation