Compartilhar via

Função JetDetachDatabase2

  • Artigo

Aplica-se a: Windows | Windows Server

Função JetDetachDatabase2

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

O Windows XP:JetDetachDatabase2 é introduzido no Windows XP.

    JET_ERR JET_API JetDetachDatabase2(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename,
      __in          JET_GRBIT grbit
    );

Parâmetros

sesid

O contexto de sessão do 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 .

grbit

Um grupo de bits que especifica zero ou mais das opções a seguir.

Valor

Significado

JET_bitForceCloseAndDetach

Força o banco de dados a ser fechado e desanexado. Se JET_bitForceCloseAndDetach não tiver suporte, JET_errForceDetachNotAllowed será retornado.

JET_bitForceDetach

Força o banco de dados a ser desanexado. Se JET_bitForceDetach não tiver suporte, JET_errForceDetachNotAllowed será retornado.

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 de 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 copiado em 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_errForceDetachNotAllowed

não há suporte para JET_bitForceDetach.

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 o Windows Vista ou o Windows XP.

Servidor

Requer o Windows Server 2008 ou o Windows Server 2003.

Cabeçalho

Declarado em Esent.h.

Biblioteca

Use ESENT.lib.

DLL

Requer ESENT.dll.

Unicode

Implementado como JetDetachDatabase2W (Unicode) e JetDetachDatabase2A (ANSI).

Consulte Também

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