JetOpenDatabase 函数

适用于： Windows |Windows Server

JetOpenDatabase 函数

JetOpenDatabase 函数使用 JetAttachDatabase 或 JetAttachDatabase2 函数打开以前附加的数据库，以便与数据库会话一起使用。 对于同一数据库，可以多次调用此函数。

    JET_ERR JET_API JetOpenDatabase(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename,
      __in_opt      const tchar* szConnect,
      __out         JET_DBID* pdbid,
      __in          JET_GRBIT grbit
    );

parameters

sesid

用于 API 调用的数据库会话上下文。

szFilename

要打开的数据库的名称。

szConnect

保留。 设置为 NULL。

pdbid

指向缓冲区的指针，该缓冲区在成功调用时包含数据库的标识符。 如果调用失败，则值未定义。

grbit

一组指定以下选项的零个或多个位。

值	含义
JET_bitDbExclusive	仅允许单个会话附加数据库。 通常，多个会话可以打开数据库。
JET_bitDbReadOnly	防止对数据库进行修改。

返回值

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

返回代码	说明
JET_errSuccess	操作已成功完成。
JET_errDatabaseInUse	已请求独占访问，但无法授予。
JET_errDatabaseInvalidPath	szFilename 中提供了无效的路径。 szFilename 必须是非 NULL 且引用有效的文件。
JET_errDatabaseLocked	另一个会话已使用 JET_bitDbExclusive) 以独占方式打开数据库 (。
JET_errDatabaseNotFound	以前未附加数据库 (请参阅 JetAttachDatabase) 。
JET_errInvalidDatabase	尝试打开不是有效数据库文件的文件。
JET_errOneDatabasePerSession	尝试打开多个数据库，并设置了 JET_paramOneDatabasePerSession 。 有关详细信息，请参阅 系统参数。
JET_wrnFileOpenReadOnly	该文件已作为只读附加，但 JetOpenDatabase 未传递JET_bitDbReadOnly。 数据库仍以只读访问权限打开。

要求

要求	值
客户端	需要 Windows Vista、Windows XP 或 Windows 2000 Professional。
服务器	需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。
标头	在 Esent.h 中声明。
Library	使用 ESENT.lib。
DLL	需要ESENT.dll。
Unicode	作为 JetOpenDatabaseW (Unicode) 和 JetOpenDatabaseA (ANSI) 实现。

另请参阅

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetSetSystemParameter
系统参数