JetGetLock 函数

适用于: Windows |Windows Server

JetGetLock 函数

JetGetLock 函数提供了一种显式保留更新行、写入锁或显式阻止任何其他会话更新行、读取锁的功能的方法。 通常,由于更新行,行写入锁是隐式获取的。 由于记录版本控制,通常不需要读取锁。 但是,在某些情况下,事务可能需要显式锁定行以强制实施序列化,或者为了确保后续操作会成功,而所需的锁已被占用。

JET_ERR JET_API JetGetLock(
  __in          JET_SESID sesid,
  __in          JET_TABLEID tableid,
  __in          JET_GRBIT grbit
);

参数

sesid

将用于此调用的会话。

tableid

将用于此调用的游标。

grbit

一组位,其中包含要用于此调用的选项,其中包括以下零个或多个内容:

含义

JET_bitReadLock

此标志会导致获取当前记录的读取锁。 读取锁与其他会话已持有的写入锁不兼容,但与其他会话持有的读取锁兼容。

JET_bitWriteLock

此标志会导致获取当前记录上的写入锁。 写入锁与其他会话持有的写入或读取锁不兼容,但与同一会话持有的读取锁兼容。

返回值

此函数返回具有以下返回代码之一 的JET_ERR 数据类型。 有关可能的 ESE 错误的详细信息,请参阅 可扩展存储引擎错误错误处理参数

返回代码

说明

JET_errSuccess

操作已成功完成。

JET_errClientRequestToStopJetService

无法完成操作,因为与会话关联的实例上的所有活动都因调用 JetStopService 而停止。

JET_errInstanceUnavailable

无法完成操作,因为与会话关联的实例遇到严重错误,要求撤销对所有数据的访问权限以保护该数据的完整性。 此错误仅由 Windows XP 及更高版本返回。

JET_errInvalidgrbit

给定 的 grbit 既不是JET_bitReadLock也不是JET_bitWriteLock。 它必须是这两个标志之一。

JET_errNoCurrentRecord

游标必须位于记录上才能获取锁。 锁始终在记录上。

JET_errNotInitialized

无法完成操作,因为与会话关联的实例尚未初始化。

JET_errNotInTransaction

只有事务中的会话才能获取锁。

JET_errPermissionDenied

游标不能是只读的,不能获取写入锁。

JET_errRestoreInProgress

无法完成该操作,因为正在对与会话关联的实例执行还原操作。

JET_errSessionSharingViolation

同一会话不能同时用于多个线程。 此错误仅由 Windows XP 及更高版本返回。

JET_errTermInProgress

无法完成操作,因为正在关闭与会话关联的实例。

JET_errTransReadOnly

会话必须具有写入权限才能获取写入锁。

JET_errWriteConflict

请求冲突锁时返回的错误。

成功后,会话已获取请求的锁。

失败时,会话尚未获取请求的锁。

备注

无法通过具有只读权限的会话或游标获取写入锁,即使会话和游标最终不执行更新操作也是如此。 会话和游标必须具有写入权限才能获取写入锁。

读取和写入锁是悲观锁定的一种方式。 悲观锁定要求多个并发会话发生冲突,并提前获取锁,以确保其操作成功。

由于隐式采用的锁,大多数操作都是可序列化的。 但是,某些操作不会。 为了说明这一点,请考虑两个事务:

T1:R (A) 、U (B)

T2:R (B) 、U (A)

记录级别版本控制将确保并发执行的每个事务都将看到 A 和 B 的原始值。如果结果依赖于数据读取,则没有可以为 A 和 B 生成相同结果的串行执行顺序。 为了使此事务可序列化,应用程序应在读取值时在每个事务中的 A 和 B 上获取显式读取锁。

要求

要求

客户端

需要 Windows Vista、Windows XP 或 Windows 2000 专业版。

服务器

需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。

标头

在 Esent.h 中声明。

Library

使用 ESENT.lib。

DLL

需要ESENT.dll。

另请参阅

JET_ERR
JET_SESID
JET_TABLEID
JetPrepareUpdate
JetStopService
JetUpdate