Función JetDetachDatabase

Se aplica a: Windows | Windows Server

Función JetDetachDatabase

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

    JET_ERR JET_API JetDetachDatabase(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename
    );

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 .

Valor devuelto

Esta función devuelve el tipo de datos JET_ERR 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 (vea JetAttachDatabase o JetAttachDatabase2).

JET_errInTransaction

Se intentó desasociar una base de datos mientras se encontraba en una transacción.

Comentarios

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

Windows solo 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 Valor

Cliente

Requiere Windows Vista, Windows XP o Windows 2000 Professional.

Server

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 JetDetachDatabaseW (Unicode) y JetDetachDatabaseA (ANSI).

Vea también

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetCreateDatabase
JetCreateDatabase2
JetCloseDatabase
JetTerm