Función JetOpenDatabase

Artículo
06/13/2023

Se aplica a: Windows | Windows Server

Función JetOpenDatabase

La función JetOpenDatabase abre una base de datos adjunta previamente, mediante las funciones JetAttachDatabase o JetAttachDatabase2 , para su uso con una sesión de base de datos. Se puede llamar a esta función varias veces para la misma base de datos.

    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
    );

Parámetros

sesid

Contexto de sesión de base de datos que se va a usar para la llamada API.

szFilename

Nombre de la base de datos que se va a abrir.

szConnect

Reservado. Definición en NULL

pdbid

Puntero a un búfer que, en una llamada correcta, contiene el identificador de la base de datos. Si se produce un error en la llamada, el valor no está definido.

grbit

Un grupo de bits que especifica cero o más de las siguientes opciones.

Valor	Significado
JET_bitDbExclusive	Permite que solo una sesión adjunte una base de datos. Normalmente, varias sesiones pueden abrir una base de datos.
JET_bitDbReadOnly	Impide modificaciones en la base de datos.

Valor devuelto

Esta función devuelve el JET_ERR tipo de datos con uno de los siguientes códigos de retorno. Para obtener más información sobre los posibles errores de ESE, vea Extensible Storage Engine Errors and Error Handling Parameters.

Código devuelto	Descripción
JET_errSuccess	La operación se ha completado correctamente.
JET_errDatabaseInUse	Se solicitó acceso exclusivo, pero no se pudo conceder.
JET_errDatabaseInvalidPath	Se ha proporcionado una ruta de acceso no válida en szFilename. szFilename debe ser distinto de NULL y hacer referencia a un archivo válido.
JET_errDatabaseLocked	Otra sesión ya ha abierto la base de datos exclusivamente (con JET_bitDbExclusive).
JET_errDatabaseNotFound	La base de datos no se adjuntó anteriormente (consulte JetAttachDatabase).
JET_errInvalidDatabase	Se intentó abrir un archivo que no es un archivo de base de datos válido.
JET_errOneDatabasePerSession	Se intentó abrir más de una base de datos y se estableció JET_paramOneDatabasePerSession . Para obtener más información, consulte Parámetros del sistema.
JET_wrnFileOpenReadOnly	El archivo se adjuntó como de solo lectura, pero JetOpenDatabase no pasó JET_bitDbReadOnly. La base de datos todavía se abre con acceso de solo lectura.

Requisitos

Requisito	Value
Cliente	Requiere Windows Vista, Windows XP o Windows 2000 Professional.
Servidor	Requiere Windows Server 2008, Windows Server 2003 o Windows 2000 Server.
Encabezado	Declarado en Esent.h.
Library	Use ESENT.lib.
Archivo DLL	Requiere ESENT.dll.
Unicode	Se implementa como JetOpenDatabaseW (Unicode) y JetOpenDatabaseA (ANSI).

Consulte también

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetSetSystemParameter
Parámetros del sistema

Función JetOpenDatabase