Função JetDetachDatabase

Aplica-se a: Windows | Windows Server

Função JetDetachDatabase

A função JetDetachDatabase libera um arquivo de banco de dados que foi anexado anteriormente a uma sessão de banco de dados.

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

Parâmetros

sesid

O contexto de sessão de banco de dados a ser usado para a chamada à API.

szFilename

O nome do banco de dados a ser desanexados. Se szFilename for NULL ou uma cadeia de caracteres vazia, todos os bancos de dados anexados à sesid serão desanexados .

Valor Retornado

Essa função retorna o tipo de dados JET_ERR com um dos seguintes códigos de retorno. Para obter mais informações sobre os possíveis erros do ESE, consulte Erros extensíveis do mecanismo de armazenamento e parâmetros de tratamento de erros.

Código de retorno	Descrição
JET_errSuccess	A operação foi concluída com sucesso.
JET_errBackupInProgress	O banco de dados está sendo feito backup e não pode ser desanexado.
JET_errDatabaseInUse	O banco de dados foi aberto pelo JetOpenDatabase. Os bancos de dados devem ser fechados antes da desanexação.
JET_errDatabaseNotFound	O banco de dados não foi anexado anteriormente (consulte JetAttachDatabase ou JetAttachDatabase2).
JET_errInTransaction	Foi feita uma tentativa de desanexar um banco de dados durante uma transação.

Comentários

Se um banco de dados anexado tiver sido aberto (com JetAttachDatabase), ele deverá ser fechado com JetCloseDatabase antes de desanexar.

Somente Windows 2000: bancos de dados que não foram desanexados antes de chamar JetTerm serão anexados automaticamente quando JetInit for chamado em seguida.

Requisitos

Requisito	Valor
Cliente	Requer Windows Vista, Windows XP ou Windows 2000 Professional.
Servidor	Requer o Windows Server 2008, o Windows Server 2003 ou o Windows 2000 Server.
Cabeçalho	Declarado em Esent.h.
Biblioteca	Use ESENT.lib.
DLL	Requer ESENT.dll.
Unicode	Implementado como JetDetachDatabaseW (Unicode) e JetDetachDatabaseA (ANSI).

Consulte Também

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetCreateDatabase
JetCreateDatabase2
JetCloseDatabase
JetTerm