Función JetDetachDatabase2

Artículo
06/13/2023

Se aplica a: Windows | Windows Server

Función JetDetachDatabase2

La función JetDetachDatabase2 libera un archivo de base de datos que se adjuntó anteriormente a una sesión de base de datos.

Windows XP:JetDetachDatabase2 se introduce en Windows XP.

    JET_ERR JET_API JetDetachDatabase2(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename,
      __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 desasociar. Si szFilename es NULL o una cadena vacía, se desasociarán todas las bases de datos adjuntas a sesid .

grbit

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

Value	Significado
JET_bitForceCloseAndDetach	Obliga a que la base de datos se cierre y se desasocie. Si no se admite JET_bitForceCloseAndDetach, se devolverá JET_errForceDetachNotAllowed.
JET_bitForceDetach	Obliga a desasociar la base de datos. Si no se admite JET_bitForceDetach, se devolverá JET_errForceDetachNotAllowed.

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_errBackupInProgress	Se está realizando una copia de seguridad de la base de datos y no se puede desasociar.
JET_errDatabaseInUse	JetOpenDatabase ha abierto la base de datos. Las bases de datos deben cerrarse antes de desasociar.
JET_errDatabaseNotFound	La base de datos no se adjuntó anteriormente (consulte JetAttachDatabase o JetAttachDatabase2).
JET_errForceDetachNotAllowed	no se admite JET_bitForceDetach.
JET_errInTransaction	Se intentó desasociar una base de datos mientras estaba en una transacción.

Comentarios

Si se abrió una base de datos adjunta (con JetAttachDatabase), debe cerrarse con JetCloseDatabase antes de desasociar.

Solo Windows 2000: las bases de datos que no se han desasociado antes de llamar a JetTerm se volverán a adjuntar automáticamente cuando se llame a JetInit .

Requisitos

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

Consulte también

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetCloseDatabase
JetCreateDatabase
JetCreateDatabase2
JetInit
JetOpenDatabase
JetTerm

Función JetDetachDatabase2