ReadOnlyEnlistment 函数 (ktmw32.h)

请求将指定的登记转换为只读登记。 只读登记不能参与事务的结果,并且不会持久记录以供恢复。

语法

BOOL ReadOnlyEnlistment(
  [in] HANDLE         EnlistmentHandle,
  [in] PLARGE_INTEGER TmVirtualClock
);

参数

[in] EnlistmentHandle

登记的句柄。

[in] TmVirtualClock

为此登记收到的最新虚拟时钟值。 如果指定 NULL,则不会更改虚拟时钟值。 请参阅 LARGE_INTEGER

若要更改虚拟时钟值,此值必须大于 COMMIT 通知中返回的当前值。

返回值

如果该函数成功,则返回值为非零值。

如果函数失败,则返回值为零 (0)。 若要获得更多的错误信息,请调用 GetLastError 函数。

以下列表标识了可能的错误代码:

注解

如果资源管理器不再需要在不回滚事务的情况下参与事务,则应在关闭登记句柄之前调用 ReadOnlyEnlistment

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 ktmw32.h
Library Ktmw32.lib
DLL Ktmw32.dll

另请参阅

GetCurrentClockTransactionManager

内核事务管理器函数

ReadOnlyEnlistment