Função JetOpenDatabase

Artigo
06/13/2023

Aplica-se a: Windows | Windows Server

Função JetOpenDatabase

A função JetOpenDatabase abre um banco de dados anexado anteriormente, usando as funções JetAttachDatabase ou JetAttachDatabase2 , para uso com uma sessão de banco de dados. Essa função pode ser chamada várias vezes para o mesmo banco de dados.

    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

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 aberto.

szConnect

Reservado. Definido como NULL.

pdbid

Ponteiro para um buffer que, em uma chamada bem-sucedida, contém o identificador do banco de dados. Se a chamada falhar, o valor será indefinido.

grbit

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

Valor	Significado
JET_bitDbExclusive	Permite que apenas uma única sessão anexe um banco de dados. Normalmente, várias sessões podem abrir um banco de dados.
JET_bitDbReadOnly	Impede modificações no banco de dados.

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_errDatabaseInUse	O acesso exclusivo foi solicitado, mas não pôde ser concedido.
JET_errDatabaseInvalidPath	Um caminho inválido foi fornecido em szFilename. szFilename deve ser não NULL e fazer referência a um arquivo válido.
JET_errDatabaseLocked	Outra sessão já abriu o banco de dados exclusivamente (usando JET_bitDbExclusive).
JET_errDatabaseNotFound	O banco de dados não foi anexado anteriormente (consulte JetAttachDatabase).
JET_errInvalidDatabase	Foi feita uma tentativa de abrir um arquivo que não é um arquivo de banco de dados válido.
JET_errOneDatabasePerSession	Foi feita uma tentativa de abrir mais de um banco de dados e JET_paramOneDatabasePerSession foi definido. Para obter mais informações, consulte Parâmetros do sistema.
JET_wrnFileOpenReadOnly	O arquivo foi anexado como somente leitura, mas JetOpenDatabase não passou JET_bitDbReadOnly. O banco de dados ainda é aberto com acesso somente leitura.

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 JetOpenDatabaseW (Unicode) e JetOpenDatabaseA (ANSI).

Consulte Também

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetSetSystemParameter
Parâmetros do sistema

Função JetOpenDatabase