Función JetOpenDatabase

  • Artículo

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