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